mcs/class/System.Configuration/System.Configuration/ConfigurationLocation.cs

   1 //
   2 // System.Configuration.ConfigurationLocation.cs
   3 //
   4 // Authors:
   5 //      Duncan Mak (duncan@ximian.com)
   6 //  Lluis Sanchez Gual (lluis@novell.com)
   7 //
   8 // Permission is hereby granted, free of charge, to any person obtaining
   9 // a copy of this software and associated documentation files (the
  10 // "Software"), to deal in the Software without restriction, including
  11 // without limitation the rights to use, copy, modify, merge, publish,
  12 // distribute, sublicense, and/or sell copies of the Software, and to
  13 // permit persons to whom the Software is furnished to do so, subject to
  14 // the following conditions:
  15 //
  16 // The above copyright notice and this permission notice shall be
  17 // included in all copies or substantial portions of the Software.
  18 //
  19 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  20 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  21 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  22 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  23 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  24 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  25 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  26 //
  27 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
  28 //
  29
  30 using System.Xml;
  31 using System.IO;
  32
  33 namespace System.Configuration {
  34
  35         public class ConfigurationLocation
  36         {
  37                 static readonly char[] pathTrimChars = { '/' };
  38
  39                 string path;
  40                 Configuration configuration;
  41                 Configuration parent;
  42                 string xmlContent;
  43                 bool parentResolved;
  44                 bool allowOverride;
  45
  46                 internal ConfigurationLocation()
  47                 {
  48                 }
  49
  50                 internal ConfigurationLocation (string path, string xmlContent, Configuration parent, bool allowOverride)
  51                 {
  52                         if (!String.IsNullOrEmpty (path)) {
  53                                 switch (path [0]) {
  54                                         case ' ':
  55                                         case '.':
  56                                         case '/':
  57                                         case '\\':
  58                                                 throw new ConfigurationErrorsException ("<location> path attribute must be a relative virtual path.  It cannot start with any of ' ' '.' '/' or '\\'.");
  59                                 }
  60
  61                                 path = path.TrimEnd (pathTrimChars);
  62                         }
  63
  64                         this.path = path;
  65                         this.xmlContent = xmlContent;
  66                         this.parent = parent;
  67                         this.allowOverride = allowOverride;
  68                 }
  69
  70                 public string Path {
  71                         get { return path; }
  72                 }
  73
  74                 internal bool AllowOverride {
  75                         get { return allowOverride; }
  76                 }
  77
  78                 internal string XmlContent {
  79                         get { return xmlContent; }
  80                 }
  81
  82                 internal Configuration OpenedConfiguration {
  83                         get { return configuration; }
  84                 }
  85
  86                 public Configuration OpenConfiguration ()
  87                 {
  88                         if (configuration == null) {
  89                                 if (!parentResolved) {
  90                                         Configuration parentFile = parent.GetParentWithFile ();
  91                                         if (parentFile != null) {
  92                                                 string parentRelativePath = parent.ConfigHost.GetConfigPathFromLocationSubPath (parent.LocationConfigPath, path);
  93                                                 parent = parentFile.FindLocationConfiguration (parentRelativePath, parent);
  94                                         }
  95                                 }
  96
  97                                 configuration = new Configuration (parent, path);
  98                                 using (XmlTextReader tr = new ConfigXmlTextReader (new StringReader (xmlContent), path))
  99                                         configuration.ReadData (tr, allowOverride);
 100
 101                                 xmlContent = null;
 102                         }
 103                         return configuration;
 104                 }
 105
 106                 internal void SetParentConfiguration (Configuration parent)
 107                 {
 108                         if (parentResolved)
 109                                 return;
 110
 111                         parentResolved = true;
 112                         this.parent = parent;
 113                         if (configuration != null)
 114                                 configuration.Parent = parent;
 115                 }
 116         }
 117 }
 118