{"id":40,"date":"2005-08-04T09:21:15","date_gmt":"2005-08-04T16:21:15","guid":{"rendered":"http:\/\/kennyw.com\/indigo\/40"},"modified":"2005-08-04T09:21:15","modified_gmt":"2005-08-04T16:21:15","slug":"channels-130-configuration-support","status":"publish","type":"post","link":"https:\/\/kennyw.com\/?p=40","title":{"rendered":"Channels 130: Configuration support"},"content":{"rendered":"

The final piece that we need to add to our Transport is configuration support. To expose our transport through config, we need to implement two configuration sections.<\/p>\n

Binding Element Extension Section<\/h4>\n

The first class we add is to configure UdpTransportBindingElement. This is so that custom binding implementations can include udp. In UdpTransportSection<\/em> we define our configuration section name (how we are referenced from config), the type of our binding element, and how to create our binding element; all with just a few simple overrides. We can then register our extension section in a .config file as follows:<\/p>\n

\n<configuration>
\n <system.serviceModel>
\n  <extensions>
\n   <bindingelementextensions>
\n    <add name=\"udpTransport\" type=\"Microsoft.ServiceModel.Samples.UdpTransportSection, UdpTransport\" \/><\/strong><\/code>
\n   <\/bindingelementextensions>
\n  <\/extensions>
\n <\/system>
\n<\/configuration>\n<\/div>\n

And it can be referenced from custom bindings to use UDP as their transport:<\/p>\n

\n<configuration>
\n <system.serviceModel>
\n  <bindings>
\n   <customBinding>
\n    <binding configurationName=”UdpCustomBinding”>
\n     <udpTransport\/><\/strong><\/code>
\n    <\/binding>
\n   <\/customBinding>
\n  <\/bindings>
\n <\/system.serviceModel>
\n<\/configuration>\n<\/div>\n

Binding Section<\/h4>\n

The second class we add is to configure SampleProfileUdpBinding, our “standard binding”. Through SampleProfileUdpBindingSection<\/em> we expose this binding to the configuration system. Most of the methods delegate to SampleProfileUdpBindingConfigurationElement<\/em>, which derives from StandardBindingConfigurationElement<\/em>.<\/p>\n

SampleProfileUdpBindingConfigurationElement has properties that correspond to the properties on SampleProfileUdpBinding, and functions that map from the ConfigurationElement to Binding and vice-versa.<\/p>\n

Finally, we need to override the OnApplyConfiguration() function in our SampleProfileUdpBinding:<\/p>\n

\n protected override void<\/code> OnApplyConfiguration(string<\/code> configurationName)
\n {<\/p>\n
SampleProfileUdpBindingSection<\/code> section = (SampleProfileUdpBindingSection<\/code>)ConfigurationManager<\/code>.GetSection(UdpConstants<\/code>.UdpBindingSectionName);
\n SampleProfileUdpBindingConfigurationElement<\/code> element = section.Bindings[configurationName];
\n if<\/code> (element == null<\/code>)
\n {<\/p>\n
throw new<\/code> ConfigurationErrorsException<\/code>(string<\/code>.Format(CultureInfo<\/code>.CurrentCulture, “There is no binding named {0} at {1}.”, configurationName, section.SectionInformation.Name));<\/div>\n

}
\n else<\/code>
\n {<\/p>\n

element.ApplyConfiguration(this<\/code>);<\/div>\n

}<\/p><\/div>\n

}<\/p><\/div>\n

To register this handler with the configuration system, we add the following section to a .config file:<\/p>\n

\n<configuration>
\n <configSections>
\n  <sectionGroup name=”system.serviceModel”>
\n   <sectionGroup name=”bindings”>
\n    <section name=\"sampleProfileUdpBinding\" type=\"Microsoft.ServiceModel.Samples.SampleProfileUdpBindingSection, UdpTransport\" \/><\/strong><\/code>
\n   <\/sectionGroup>
\n  <\/sectionGroup>
\n <\/configSections>
\n<\/configuration>\n<\/div>\n

It can then be referenced from serviceModel config:<\/p>\n

\n<configuration>
\n <system.serviceModel>
\n  <client>
\n   <endpoint configurationName=”calculator”<\/p>\n
address=”soap.udp:\/\/localhost:8080\/”
\n bindingConfiguration=”CalculatorServer”
\n bindingSectionName=\"sampleProfileUdpBinding\"<\/strong><\/code>
\n contractType= “Microsoft.ServiceModel.Samples.ICalculatorContract”><\/div>\n

   <\/endpoint>
\n  <\/client>
\n <\/system.serviceModel>
\n<\/configuration>\n<\/p><\/div>\n

The result is a completely functional third party transport that can be used in any Indigo program!<\/p>\n","protected":false},"excerpt":{"rendered":"

The final piece that we need to add to our Transport is configuration support. To expose our transport through config, we need to implement two configuration sections. Binding Element Extension Section The first class we add is to configure UdpTransportBindingElement. This is so that custom binding implementations can include udp. In UdpTransportSection we define our […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-40","post","type-post","status-publish","format-standard","hentry","category-indigo"],"_links":{"self":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/posts\/40","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=40"}],"version-history":[{"count":0,"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/posts\/40\/revisions"}],"wp:attachment":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=40"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=40"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=40"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}