We need you! We're working hard on the next version of Developer Fusion - Let us know what you think we should be up to!

The Labs \ Source Viewer \ SSCLI \ System.Runtime.Remoting.Activation \ LifetimeEntry

SSCLI
  1. // ==++==
  2. //
  3. //
  4. // Copyright (c) 2006 Microsoft Corporation. All rights reserved.
  5. //
  6. // The use and distribution terms for this software are contained in the file
  7. // named license.txt, which can be found in the root of this distribution.
  8. // By using this software in any fashion, you are agreeing to be bound by the
  9. // terms of this license.
  10. //
  11. // You must not remove this notice, or any other, from this software.
  12. //
  13. //
  14. // ==--==
  15. /*============================================================
  16. **
  17. **  File:    RemotingConfigParser.cs
  18. **
  19. **  Purpose: Parse remoting configuration files.
  20. **
  21. **
  22. ===========================================================*/
  24. using System;
  25. using System.Collections;
  26. using System.IO;
  27. using System.Reflection;
  28. using System.Runtime.Remoting;
  29. using System.Runtime.Remoting.Channels;
  30. using System.Globalization;
  31. using System.Runtime.Versioning;
  33. namespace System.Runtime.Remoting.Activation
  34. {
  35.    
  36.    
  37.     internal class RemotingXmlConfigFileData
  38.     {
  39.         // debug settings
  40.         static internal bool LoadTypes = false;
  41.         // indicates whether we should attempt to load types in config files
  42.        
  43.         //
  44.         // configuration entry storage classes (in alphabetical order)
  45.         // There is one class for each type of entry in a remoting config file.
  46.         //
  47.        
  48.         internal class ChannelEntry
  49.         {
  50.             internal string TypeName;
  51.             internal string AssemblyName;
  52.             internal Hashtable Properties;
  53.             internal bool DelayLoad = false;
  54.             internal ArrayList ClientSinkProviders = new ArrayList();
  55.             internal ArrayList ServerSinkProviders = new ArrayList();
  56.            
  57.             internal ChannelEntry(string typeName, string assemblyName, Hashtable properties)
  58.             {
  59.                 TypeName = typeName;
  60.                 AssemblyName = assemblyName;
  61.                 Properties = properties;
  62.             }
  63.             // ChannelEntry
  64.         }
  65.         // class ChannelEntry
  66.        
  67.         internal class ClientWellKnownEntry
  68.         {
  69.             internal string TypeName;
  70.             internal string AssemblyName;
  71.             internal string Url;
  72.            
  73.             internal ClientWellKnownEntry(string typeName, string assemName, string url)
  74.             {
  75.                 TypeName = typeName;
  76.                 AssemblyName = assemName;
  77.                 Url = url;
  78.             }
  79.         }
  80.         // class ClientWellKnownEntry
  81.        
  82.         internal class ContextAttributeEntry
  83.         {
  84.             internal string TypeName;
  85.             internal string AssemblyName;
  86.             internal Hashtable Properties;
  87.            
  88.             internal ContextAttributeEntry(string typeName, string assemName, Hashtable properties)
  89.             {
  90.                 TypeName = typeName;
  91.                 AssemblyName = assemName;
  92.                 Properties = properties;
  93.             }
  94.         }
  95.         // class ContextAttributeEntry
  96.        
  97.         internal class InteropXmlElementEntry
  98.         {
  99.             internal string XmlElementName;
  100.             internal string XmlElementNamespace;
  101.             internal string UrtTypeName;
  102.             internal string UrtAssemblyName;
  103.            
  104.             internal InteropXmlElementEntry(string xmlElementName, string xmlElementNamespace, string urtTypeName, string urtAssemblyName)
  105.             {
  106.                 XmlElementName = xmlElementName;
  107.                 XmlElementNamespace = xmlElementNamespace;
  108.                 UrtTypeName = urtTypeName;
  109.                 UrtAssemblyName = urtAssemblyName;
  110.             }
  111.         }
  112.         // class InteropXmlElementEntry
  113.         internal class CustomErrorsEntry
  114.         {
  115.             internal CustomErrorsModes Mode;
  116.            
  117.             internal CustomErrorsEntry(CustomErrorsModes mode)
  118.             {
  119.                 Mode = mode;
  120.             }
  121.         }
  122.        
  123.         internal class InteropXmlTypeEntry
  124.         {
  125.             internal string XmlTypeName;
  126.             internal string XmlTypeNamespace;
  127.             internal string UrtTypeName;
  128.             internal string UrtAssemblyName;
  129.            
  130.             internal InteropXmlTypeEntry(string xmlTypeName, string xmlTypeNamespace, string urtTypeName, string urtAssemblyName)
  131.             {
  132.                 XmlTypeName = xmlTypeName;
  133.                 XmlTypeNamespace = xmlTypeNamespace;
  134.                 UrtTypeName = urtTypeName;
  135.                 UrtAssemblyName = urtAssemblyName;
  136.             }
  137.         }
  138.         // class InteropXmlTypeEntry
  139.        
  140.         internal class LifetimeEntry
  141.         {
  142.             // If any of these are false, then the corresponding property wasn't specified
  143.             // in the config file.
  144.             internal bool IsLeaseTimeSet = false;
  145.             internal bool IsRenewOnCallTimeSet = false;
  146.             internal bool IsSponsorshipTimeoutSet = false;
  147.             internal bool IsLeaseManagerPollTimeSet = false;
  148.            
  149.             private TimeSpan _leaseTime;
  150.             private TimeSpan _renewOnCallTime;
  151.             private TimeSpan _sponsorshipTimeout;
  152.             private TimeSpan _leaseManagerPollTime;
  153.            
  154.             internal TimeSpan LeaseTime {
  155.                 get {
  156.                     BCLDebug.Assert(IsLeaseTimeSet == true, "LeaseTime not set");
  157.                     return _leaseTime;
  158.                 }
  159.                 set {
  160.                     _leaseTime = value;
  161.                     IsLeaseTimeSet = true;
  162.                 }
  163.             }
  164.            
  165.             internal TimeSpan RenewOnCallTime {
  166.                 get {
  167.                     BCLDebug.Assert(IsRenewOnCallTimeSet == true, "RenewOnCallTime not set");
  168.                     return _renewOnCallTime;
  169.                 }
  170.                 set {
  171.                     _renewOnCallTime = value;
  172.                     IsRenewOnCallTimeSet = true;
  173.                 }
  174.             }
  175.            
  176.             internal TimeSpan SponsorshipTimeout {
  177.                 get {
  178.                     BCLDebug.Assert(IsSponsorshipTimeoutSet == true, "SponsorShipTimeout not set");
  179.                     return _sponsorshipTimeout;
  180.                 }
  181.                 set {
  182.                     _sponsorshipTimeout = value;
  183.                     IsSponsorshipTimeoutSet = true;
  184.                 }
  185.             }
  186.            
  187.             internal TimeSpan LeaseManagerPollTime {
  188.                 get {
  189.                     BCLDebug.Assert(IsLeaseManagerPollTimeSet == true, "LeaseManagerPollTime not set");
  190.                     return _leaseManagerPollTime;
  191.                 }
  192.                 set {
  193.                     _leaseManagerPollTime = value;
  194.                     IsLeaseManagerPollTimeSet = true;
  195.                 }
  196.             }
  197.            
  198.         }
  199.         // class LifetimeEntry
  200.        
  201.         internal class PreLoadEntry
  202.         {
  203.             // If TypeName is null, then all types in the assembly specified
  204.             // should be preloaded.
  205.            
  206.             internal string TypeName;
  207.             internal string AssemblyName;
  208.            
  209.             public PreLoadEntry(string typeName, string assemblyName)
  210.             {
  211.                 TypeName = typeName;
  212.                 AssemblyName = assemblyName;
  213.             }
  214.         }
  215.         // class PreLoadEntry
  216.        
  217.         internal class RemoteAppEntry
  218.         {
  219.             internal string AppUri;
  220.            
  221.             internal ArrayList WellKnownObjects = new ArrayList();
  222.             internal ArrayList ActivatedObjects = new ArrayList();
  223.            
  224.             internal RemoteAppEntry(string appUri)
  225.             {
  226.                 AppUri = appUri;
  227.             }
  228.            
  229.             internal void AddWellKnownEntry(string typeName, string assemName, string url)
  230.             {
  231.                 ClientWellKnownEntry cwke = new ClientWellKnownEntry(typeName, assemName, url);
  232.                 WellKnownObjects.Add(cwke);
  233.             }
  234.            
  235.             internal void AddActivatedEntry(string typeName, string assemName, ArrayList contextAttributes)
  236.             {
  237.                 TypeEntry te = new TypeEntry(typeName, assemName, contextAttributes);
  238.                 ActivatedObjects.Add(te);
  239.             }
  240.            
  241.         }
  242.         // class RemoteAppEntry
  243.        
  244.         internal class ServerWellKnownEntry : TypeEntry
  245.         {
  246.             internal string ObjectURI;
  247.             internal WellKnownObjectMode ObjectMode;
  248.            
  249.             internal ServerWellKnownEntry(string typeName, string assemName, ArrayList contextAttributes, string objURI, WellKnownObjectMode objMode) : base(typeName, assemName, contextAttributes)
  250.             {
  251.                 ObjectURI = objURI;
  252.                 ObjectMode = objMode;
  253.             }
  254.         }
  255.         // class ServerWellKnownEntry
  256.        
  257.         internal class SinkProviderEntry
  258.         {
  259.             internal string TypeName;
  260.             internal string AssemblyName;
  261.             internal Hashtable Properties;
  262.             internal ArrayList ProviderData = new ArrayList();
  263.             // array of SinkProviderData structures
  264.             internal bool IsFormatter;
  265.             // Is this a formatter sink provider?
  266.             internal SinkProviderEntry(string typeName, string assemName, Hashtable properties, bool isFormatter)
  267.             {
  268.                 TypeName = typeName;
  269.                 AssemblyName = assemName;
  270.                 Properties = properties;
  271.                 IsFormatter = isFormatter;
  272.             }
  273.         }
  274.         // class SinkProviderEntry
  275.        
  276.         internal class TypeEntry
  277.         {
  278.             internal string TypeName;
  279.             internal string AssemblyName;
  280.             internal ArrayList ContextAttributes;
  281.            
  282.             internal TypeEntry(string typeName, string assemName, ArrayList contextAttributes)
  283.             {
  284.                 TypeName = typeName;
  285.                 AssemblyName = assemName;
  286.                 ContextAttributes = contextAttributes;
  287.             }
  288.         }
  289.         // class TypeEntry
  290.        
  291.         //
  292.         // end of configuration entry storage classes
  293.         //
  294.        
  295.        
  296.         //
  297.         // configuration data access
  298.         //
  299.        
  300.         internal string ApplicationName = null;
  301.         // application name
  302.         internal LifetimeEntry Lifetime = null;
  303.         // corresponds to top-level lifetime element
  304.         internal bool UrlObjRefMode = RemotingConfigHandler.UrlObjRefMode;
  305.         // should url obj ref's be used?
  306.         internal CustomErrorsEntry CustomErrors = null;
  307.        
  308.         internal ArrayList ChannelEntries = new ArrayList();
  309.         internal ArrayList InteropXmlElementEntries = new ArrayList();
  310.         internal ArrayList InteropXmlTypeEntries = new ArrayList();
  311.         internal ArrayList PreLoadEntries = new ArrayList();
  312.         internal ArrayList RemoteAppEntries = new ArrayList();
  313.         internal ArrayList ServerActivatedEntries = new ArrayList();
  314.         internal ArrayList ServerWellKnownEntries = new ArrayList();
  315.        
  316.        
  317.         //
  318.         // end of configuration data access
  319.         //
  320.        
  321.        
  322.         //
  323.         // modify configuration data (for multiple entry entities)
  324.         //
  325.        
  326.         internal void AddInteropXmlElementEntry(string xmlElementName, string xmlElementNamespace, string urtTypeName, string urtAssemblyName)
  327.         {
  328.             TryToLoadTypeIfApplicable(urtTypeName, urtAssemblyName);
  329.             InteropXmlElementEntry ixee = new InteropXmlElementEntry(xmlElementName, xmlElementNamespace, urtTypeName, urtAssemblyName);
  330.             InteropXmlElementEntries.Add(ixee);
  331.         }
  332.        
  333.         internal void AddInteropXmlTypeEntry(string xmlTypeName, string xmlTypeNamespace, string urtTypeName, string urtAssemblyName)
  334.         {
  335.             TryToLoadTypeIfApplicable(urtTypeName, urtAssemblyName);
  336.             InteropXmlTypeEntry ixte = new InteropXmlTypeEntry(xmlTypeName, xmlTypeNamespace, urtTypeName, urtAssemblyName);
  337.             InteropXmlTypeEntries.Add(ixte);
  338.         }
  339.        
  340.         internal void AddPreLoadEntry(string typeName, string assemblyName)
  341.         {
  342.             TryToLoadTypeIfApplicable(typeName, assemblyName);
  343.             PreLoadEntry ple = new PreLoadEntry(typeName, assemblyName);
  344.             PreLoadEntries.Add(ple);
  345.         }
  346.        
  347.         internal RemoteAppEntry AddRemoteAppEntry(string appUri)
  348.         {
  349.             RemoteAppEntry rae = new RemoteAppEntry(appUri);
  350.             RemoteAppEntries.Add(rae);
  351.             return rae;
  352.         }
  353.        
  354.         internal void AddServerActivatedEntry(string typeName, string assemName, ArrayList contextAttributes)
  355.         {
  356.             TryToLoadTypeIfApplicable(typeName, assemName);
  357.             TypeEntry te = new TypeEntry(typeName, assemName, contextAttributes);
  358.             ServerActivatedEntries.Add(te);
  359.         }
  360.        
  361.         internal ServerWellKnownEntry AddServerWellKnownEntry(string typeName, string assemName, ArrayList contextAttributes, string objURI, WellKnownObjectMode objMode)
  362.         {
  363.             TryToLoadTypeIfApplicable(typeName, assemName);
  364.             ServerWellKnownEntry swke = new ServerWellKnownEntry(typeName, assemName, contextAttributes, objURI, objMode);
  365.             ServerWellKnownEntries.Add(swke);
  366.             return swke;
  367.         }
  368.        
  369.        
  370.         // debug settings helper
  371.         private void TryToLoadTypeIfApplicable(string typeName, string assemblyName)
  372.         {
  373.             if (!LoadTypes)
  374.                 return;
  375.            
  376.             Assembly asm = Assembly.Load(assemblyName);
  377.             if (asm == null) {
  378.                 throw new RemotingException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_AssemblyLoadFailed"), assemblyName));
  379.             }
  380.            
  381.             Type type = asm.GetType(typeName, false, false);
  382.             if (type == null) {
  383.                 throw new RemotingException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_BadType"), typeName));
  384.             }
  385.         }
  386.        
  387.     }
  388.     // RemotingXmlConfigFileData
  389.    
  390.    
  391.    
  392.     static internal class RemotingXmlConfigFileParser
  393.     {
  394.         // template arrays
  395.         private static Hashtable _channelTemplates = CreateSyncCaseInsensitiveHashtable();
  396.         private static Hashtable _clientChannelSinkTemplates = CreateSyncCaseInsensitiveHashtable();
  397.         private static Hashtable _serverChannelSinkTemplates = CreateSyncCaseInsensitiveHashtable();
  398.        
  399.        
  400.         private static Hashtable CreateSyncCaseInsensitiveHashtable()
  401.         {
  402.             return Hashtable.Synchronized(CreateCaseInsensitiveHashtable());
  403.         }
  404.        
  405.         private static Hashtable CreateCaseInsensitiveHashtable()
  406.         {
  407.             return new Hashtable(StringComparer.InvariantCultureIgnoreCase);
  408.         }
  409.        
  410.        
  411.         public static RemotingXmlConfigFileData ParseDefaultConfiguration()
  412.         {
  413.             ConfigNode node;
  414.            
  415.             // <system.runtime.remoting>
  416.             ConfigNode rootNode = new ConfigNode("system.runtime.remoting", null);
  417.            
  418.             /*
  419.             <application>
  420.                 <channels>
  421.                     <channel ref="http client" displayName="http client (delay loaded)" delayLoadAsClientChannel="true" />
  422.                     <channel ref="tcp client" displayName="tcp client (delay loaded)" delayLoadAsClientChannel="true" />
  423.                     <channel ref="ipc client" displayName="ipc client (delay loaded)" delayLoadAsClientChannel="true" />
  424.                 </channels>
  425.             </application>
  426.             */           
  427. ConfigNode appNode = new ConfigNode("application", rootNode);
  428.             rootNode.Children.Add(appNode);
  429.            
  430.             ConfigNode channelsNode = new ConfigNode("channels", appNode);
  431.             appNode.Children.Add(channelsNode);
  432.            
  433.             node = new ConfigNode("channel", appNode);
  434.             node.Attributes.Add(new DictionaryEntry("ref", "http client"));
  435.             node.Attributes.Add(new DictionaryEntry("displayName", "http client (delay loaded)"));
  436.             node.Attributes.Add(new DictionaryEntry("delayLoadAsClientChannel", "true"));
  437.             channelsNode.Children.Add(node);
  438.            
  439.             node = new ConfigNode("channel", appNode);
  440.             node.Attributes.Add(new DictionaryEntry("ref", "tcp client"));
  441.             node.Attributes.Add(new DictionaryEntry("displayName", "tcp client (delay loaded)"));
  442.             node.Attributes.Add(new DictionaryEntry("delayLoadAsClientChannel", "true"));
  443.             channelsNode.Children.Add(node);
  444.            
  445.             node = new ConfigNode("channel", appNode);
  446.             node.Attributes.Add(new DictionaryEntry("ref", "ipc client"));
  447.             node.Attributes.Add(new DictionaryEntry("displayName", "ipc client (delay loaded)"));
  448.             node.Attributes.Add(new DictionaryEntry("delayLoadAsClientChannel", "true"));
  449.             channelsNode.Children.Add(node);
  450.            
  451.             /*
  452.             <channels>
  453.                 <channel id="http" type="System.Runtime.Remoting.Channels.Http.HttpChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  454.                 <channel id="http client" type="System.Runtime.Remoting.Channels.Http.HttpClientChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  455.                 <channel id="http server" type="System.Runtime.Remoting.Channels.Http.HttpServerChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  456.                 <channel id="tcp" type="System.Runtime.Remoting.Channels.Tcp.TcpChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  457.                 <channel id="tcp client" type="System.Runtime.Remoting.Channels.Tcp.TcpClientChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  458.                 <channel id="tcp server" type="System.Runtime.Remoting.Channels.Tcp.TcpServerChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  459.                 <channel id="ipc" type="System.Runtime.Remoting.Channels.Ipc.IpcChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  460.                 <channel id="ipc client" type="System.Runtime.Remoting.Channels.Ipc.IpcClientChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  461.                 <channel id="ipc server" type="System.Runtime.Remoting.Channels.Ipc.IpcServerChannel, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  462.             </channels>
  463.             */           
  464. channelsNode = new ConfigNode("channels", rootNode);
  465.             rootNode.Children.Add(channelsNode);
  466.            
  467.             node = new ConfigNode("channel", channelsNode);
  468.             node.Attributes.Add(new DictionaryEntry("id", "http"));
  469.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Http.HttpChannel, " + AssemblyRef.SystemRuntimeRemoting));
  470.             channelsNode.Children.Add(node);
  471.            
  472.             node = new ConfigNode("channel", channelsNode);
  473.             node.Attributes.Add(new DictionaryEntry("id", "http client"));
  474.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Http.HttpClientChannel, " + AssemblyRef.SystemRuntimeRemoting));
  475.             channelsNode.Children.Add(node);
  476.            
  477.             node = new ConfigNode("channel", channelsNode);
  478.             node.Attributes.Add(new DictionaryEntry("id", "http server"));
  479.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Http.HttpServerChannel, " + AssemblyRef.SystemRuntimeRemoting));
  480.             channelsNode.Children.Add(node);
  481.            
  482.             node = new ConfigNode("channel", channelsNode);
  483.             node.Attributes.Add(new DictionaryEntry("id", "tcp"));
  484.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Tcp.TcpChannel, " + AssemblyRef.SystemRuntimeRemoting));
  485.             channelsNode.Children.Add(node);
  486.            
  487.             node = new ConfigNode("channel", channelsNode);
  488.             node.Attributes.Add(new DictionaryEntry("id", "tcp client"));
  489.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Tcp.TcpClientChannel, " + AssemblyRef.SystemRuntimeRemoting));
  490.             channelsNode.Children.Add(node);
  491.            
  492.             node = new ConfigNode("channel", channelsNode);
  493.             node.Attributes.Add(new DictionaryEntry("id", "tcp server"));
  494.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Tcp.TcpServerChannel, " + AssemblyRef.SystemRuntimeRemoting));
  495.             channelsNode.Children.Add(node);
  496.            
  497.             node = new ConfigNode("channel", channelsNode);
  498.             node.Attributes.Add(new DictionaryEntry("id", "ipc"));
  499.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Ipc.IpcChannel, " + AssemblyRef.SystemRuntimeRemoting));
  500.             channelsNode.Children.Add(node);
  501.            
  502.             node = new ConfigNode("channel", channelsNode);
  503.             node.Attributes.Add(new DictionaryEntry("id", "ipc client"));
  504.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Ipc.IpcClientChannel, " + AssemblyRef.SystemRuntimeRemoting));
  505.             channelsNode.Children.Add(node);
  506.            
  507.             node = new ConfigNode("channel", channelsNode);
  508.             node.Attributes.Add(new DictionaryEntry("id", "ipc server"));
  509.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.Ipc.IpcServerChannel, " + AssemblyRef.SystemRuntimeRemoting));
  510.             channelsNode.Children.Add(node);
  511.            
  512.             /*
  513.             <channelSinkProviders>
  514.                 <clientProviders>
  515.                     <formatter id="soap" type="System.Runtime.Remoting.Channels.SoapClientFormatterSinkProvider, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  516.                     <formatter id="binary" type="System.Runtime.Remoting.Channels.BinaryClientFormatterSinkProvider, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  517.                 </clientProviders>
  518.                 <serverProviders>
  519.                     <formatter id="soap" type="System.Runtime.Remoting.Channels.SoapServerFormatterSinkProvider, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  520.                     <formatter id="binary" type="System.Runtime.Remoting.Channels.BinaryServerFormatterSinkProvider, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  521.                     <provider id="wsdl" type="System.Runtime.Remoting.MetadataServices.SdlChannelSinkProvider, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  522.                 </serverProviders>
  523.             </channelSinkProviders>
  524.             */           
  525. ConfigNode channelsSinkNode = new ConfigNode("channelSinkProviders", rootNode);
  526.             rootNode.Children.Add(channelsSinkNode);
  527.            
  528.             ConfigNode clientProvidersNode = new ConfigNode("clientProviders", channelsSinkNode);
  529.             channelsSinkNode.Children.Add(clientProvidersNode);
  530.            
  531.             node = new ConfigNode("formatter", clientProvidersNode);
  532.             node.Attributes.Add(new DictionaryEntry("id", "soap"));
  533.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.SoapClientFormatterSinkProvider, " + AssemblyRef.SystemRuntimeRemoting));
  534.             clientProvidersNode.Children.Add(node);
  535.            
  536.             node = new ConfigNode("formatter", clientProvidersNode);
  537.             node.Attributes.Add(new DictionaryEntry("id", "binary"));
  538.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.BinaryClientFormatterSinkProvider, " + AssemblyRef.SystemRuntimeRemoting));
  539.             clientProvidersNode.Children.Add(node);
  540.            
  541.             ConfigNode serverProvidersNode = new ConfigNode("serverProviders", channelsSinkNode);
  542.             channelsSinkNode.Children.Add(serverProvidersNode);
  543.            
  544.             node = new ConfigNode("formatter", serverProvidersNode);
  545.             node.Attributes.Add(new DictionaryEntry("id", "soap"));
  546.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.SoapServerFormatterSinkProvider, " + AssemblyRef.SystemRuntimeRemoting));
  547.             serverProvidersNode.Children.Add(node);
  548.            
  549.             node = new ConfigNode("formatter", serverProvidersNode);
  550.             node.Attributes.Add(new DictionaryEntry("id", "binary"));
  551.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.Channels.BinaryServerFormatterSinkProvider, " + AssemblyRef.SystemRuntimeRemoting));
  552.             serverProvidersNode.Children.Add(node);
  553.            
  554.             node = new ConfigNode("provider", serverProvidersNode);
  555.             node.Attributes.Add(new DictionaryEntry("id", "wsdl"));
  556.             node.Attributes.Add(new DictionaryEntry("type", "System.Runtime.Remoting.MetadataServices.SdlChannelSinkProvider, " + AssemblyRef.SystemRuntimeRemoting));
  557.             serverProvidersNode.Children.Add(node);
  558.            
  559.             return ParseConfigNode(rootNode);
  560.         }
  561.        
  562.        
  563.         [ResourceExposure(ResourceScope.Machine)]
  564.         [ResourceConsumption(ResourceScope.Machine)]
  565.         public static RemotingXmlConfigFileData ParseConfigFile(string filename)
  566.         {
  567.             ConfigTreeParser parser = new ConfigTreeParser();
  568.             ConfigNode rootNode = parser.Parse(filename, "/configuration/system.runtime.remoting");
  569.            
  570.             return ParseConfigNode(rootNode);
  571.         }
  572.        
  573.         private static RemotingXmlConfigFileData ParseConfigNode(ConfigNode rootNode)
  574.         {
  575.             RemotingXmlConfigFileData configData = new RemotingXmlConfigFileData();
  576.            
  577.             // check to see if this file has a system.runtime.remoting section
  578.             if (rootNode == null)
  579.                 return null;
  580.            
  581.             // process attributes
  582.             foreach (DictionaryEntry entry in rootNode.Attributes) {
  583.                 string key = entry.Key.ToString();
  584.                 switch (key) {
  585.                     case "version":
  586.                        
  587.                         {
  588.                             // we ignore the version attribute because this may be used
  589.                             // by the configuration system
  590.                             break;
  591.                         }
  593.                         break;
  594.                     default:
  595.                        
  596.                         break;
  597.                 }
  598.                 // switch
  599.             }
  600.             // foreach
  601.             ConfigNode appNode = null;
  602.             // "application" node
  603.             ConfigNode channelsNode = null;
  604.             // "channels" node
  605.             ConfigNode providerNode = null;
  606.             // "channelSinkProviders" node
  607.             ConfigNode debugNode = null;
  608.             // "debug" node
  609.             ConfigNode customErrorsNode = null;
  610.             // "customErrors" node
  611.             foreach (ConfigNode node in rootNode.Children) {
  612.                 switch (node.Name) {
  613.                     case "application":
  614.                        
  615.                        
  616.                         {
  617.                             // there can only be one application node in a config file
  618.                             if (appNode != null)
  619.                                 ReportUniqueSectionError(rootNode, appNode, configData);
  620.                            
  621.                             appNode = node;
  622.                             break;
  623.                         }
  625.                         break;
  626.                     case "channels":
  627.                         // case "application"
  628.                        
  629.                         {
  630.                             if (channelsNode != null)
  631.                                 ReportUniqueSectionError(rootNode, channelsNode, configData);
  632.                            
  633.                             channelsNode = node;
  634.                             break;
  635.                         }
  637.                         break;
  638.                     case "channelSinkProviders":
  639.                         // case "channels"
  640.                        
  641.                         {
  642.                             if (providerNode != null)
  643.                                 ReportUniqueSectionError(rootNode, providerNode, configData);
  644.                            
  645.                             providerNode = node;
  646.                             break;
  647.                         }
  649.                         break;
  650.                     case "debug":
  651.                         // case "channelSinkProviders"
  652.                        
  653.                         {
  654.                             if (debugNode != null)
  655.                                 ReportUniqueSectionError(rootNode, debugNode, configData);
  656.                            
  657.                             debugNode = node;
  658.                             break;
  659.                         }
  661.                         break;
  662.                     case "customErrors":
  663.                         // case "debug"
  664.                        
  665.                         {
  666.                             if (customErrorsNode != null)
  667.                                 ReportUniqueSectionError(rootNode, customErrorsNode, configData);
  668.                            
  669.                             customErrorsNode = node;
  670.                             break;
  671.                         }
  673.                         break;
  674.                     default:
  675.                         // case "customErrors"
  676.                         break;
  677.                 }
  678.                 // switch
  679.             }
  680.             // foreach
  681.            
  682.             if (debugNode != null)
  683.                 ProcessDebugNode(debugNode, configData);
  684.            
  685.             if (providerNode != null)
  686.                 ProcessChannelSinkProviderTemplates(providerNode, configData);
  687.            
  688.             if (channelsNode != null)
  689.                 ProcessChannelTemplates(channelsNode, configData);
  690.            
  691.             if (appNode != null)
  692.                 ProcessApplicationNode(appNode, configData);
  693.            
  694.             if (customErrorsNode != null)
  695.                 ProcessCustomErrorsNode(customErrorsNode, configData);
  696.            
  697.             return configData;
  698.         }
  699.         // ParseConfigFile
  700.        
  701.         private static void ReportError(string errorStr, RemotingXmlConfigFileData configData)
  702.         {
  703.            
  704.             throw new RemotingException(errorStr);
  705.         }
  706.         // ReportError
  707.         // means section must be unique
  708.         private static void ReportUniqueSectionError(ConfigNode parent, ConfigNode child, RemotingXmlConfigFileData configData)
  709.         {
  710.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_NodeMustBeUnique"), child.Name, parent.Name), configData);
  711.         }
  712.         // ReportUniqueSectionError
  713.         private static void ReportUnknownValueError(ConfigNode node, string value, RemotingXmlConfigFileData configData)
  714.         {
  715.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_UnknownValue"), node.Name, value), configData);
  716.         }
  717.         // ReportUnknownValueError
  718.         private static void ReportMissingAttributeError(ConfigNode node, string attributeName, RemotingXmlConfigFileData configData)
  719.         {
  720.             ReportMissingAttributeError(node.Name, attributeName, configData);
  721.         }
  722.         // ReportMissingAttributeError
  723.         private static void ReportMissingAttributeError(string nodeDescription, string attributeName, RemotingXmlConfigFileData configData)
  724.         {
  725.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_RequiredXmlAttribute"), nodeDescription, attributeName), configData);
  726.         }
  727.         // ReportMissingAttributeError
  728.         private static void ReportMissingTypeAttributeError(ConfigNode node, string attributeName, RemotingXmlConfigFileData configData)
  729.         {
  730.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_MissingTypeAttribute"), node.Name, attributeName), configData);
  731.         }
  732.         // ReportMissingAttributeError
  733.         private static void ReportMissingXmlTypeAttributeError(ConfigNode node, string attributeName, RemotingXmlConfigFileData configData)
  734.         {
  735.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_MissingXmlTypeAttribute"), node.Name, attributeName), configData);
  736.         }
  737.         // ReportMissingAttributeError
  738.         private static void ReportInvalidTimeFormatError(string time, RemotingXmlConfigFileData configData)
  739.         {
  740.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_InvalidTimeFormat"), time), configData);
  741.         }
  742.         // ReportInvalidTypeFormatError
  743.         // If nodes can be represented as a template, only a template version
  744.         // can have an 'id' attribute
  745.         private static void ReportNonTemplateIdAttributeError(ConfigNode node, RemotingXmlConfigFileData configData)
  746.         {
  747.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_NonTemplateIdAttribute"), node.Name), configData);
  748.         }
  749.         // ReportNonTemplateIdAttributeError
  750.         private static void ReportTemplateCannotReferenceTemplateError(ConfigNode node, RemotingXmlConfigFileData configData)
  751.         {
  752.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_TemplateCannotReferenceTemplate"), node.Name), configData);
  753.         }
  754.         // ReportTemplateCannotReferenceTemplateError
  755.         private static void ReportUnableToResolveTemplateReferenceError(ConfigNode node, string referenceName, RemotingXmlConfigFileData configData)
  756.         {
  757.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_UnableToResolveTemplate"), node.Name, referenceName), configData);
  758.         }
  759.         // ReportUnableToResolveTemplateReferenceError
  760.         private static void ReportAssemblyVersionInfoPresent(string assemName, string entryDescription, RemotingXmlConfigFileData configData)
  761.         {
  762.             // for some entries, version information is not allowed in the assembly name
  763.             ReportError(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Remoting_Config_VersionPresent"), assemName, entryDescription), configData);
  764.         }
  765.         // ReportAssemblyVersi