mcs/class/System.Web.Services/System.Web.Services.Description/DocumentableItem.cs

   1 // \r
   2 // System.Web.Services.Description.DocumentableItem.cs\r
   3 //\r
   4 // Author:\r
   5 //   Tim Coleman (tim@timcoleman.com)\r
   6 //\r
   7 // Copyright (C) Tim Coleman, 2002\r
   8 //\r
   9
  10 //
  11 // Permission is hereby granted, free of charge, to any person obtaining
  12 // a copy of this software and associated documentation files (the
  13 // "Software"), to deal in the Software without restriction, including
  14 // without limitation the rights to use, copy, modify, merge, publish,
  15 // distribute, sublicense, and/or sell copies of the Software, and to
  16 // permit persons to whom the Software is furnished to do so, subject to
  17 // the following conditions:
  18 //
  19 // The above copyright notice and this permission notice shall be
  20 // included in all copies or substantial portions of the Software.
  21 //
  22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  29 //
  30 \r
  31 using System.ComponentModel;\r
  32 using System.Xml.Serialization;\r
  33 using System.Xml;\r
  34 \r
  35 namespace System.Web.Services.Description {\r
  36         public abstract class DocumentableItem {\r
  37 \r
  38                 #region Fields\r
  39 \r
  40                 string documentation;\r
  41 \r
  42 #if NET_2_0\r
  43                 XmlElement docElement;\r
  44 #endif\r
  45 \r
  46                 #endregion // Fields\r
  47 \r
  48                 #region Constructors\r
  49 \r
  50                 protected DocumentableItem ()\r
  51                 {\r
  52                         documentation = String.Empty;\r
  53                 }\r
  54                 \r
  55                 #endregion // Constructors\r
  56 \r
  57                 #region Properties\r
  58 \r
  59 #if NET_2_0\r
  60                 [XmlIgnore]\r
  61                 public string Documentation {\r
  62                         get { \r
  63                                 return docElement != null ? docElement.InnerText : ""; \r
  64                         }\r
  65                         \r
  66                         set {\r
  67                                 if (value == null)\r
  68                                         docElement = null;\r
  69                                 else {\r
  70                                         XmlDocument doc = new XmlDocument ();\r
  71                                         docElement = doc.CreateElement ("wsdl", "documentation", "http://schemas.xmlsoap.org/wsdl/");\r
  72                                         docElement.InnerText = value;\r
  73                                 }\r
  74                         }\r
  75                 }\r
  76                 \r
  77                 [System.Runtime.InteropServices.ComVisible(false)]\r
  78                 [XmlAnyElement (Name="documentation", Namespace="http://schemas.xmlsoap.org/wsdl/")]\r
  79                 public XmlElement DocumentationElement {\r
  80                         get { return docElement; }\r
  81                         set { docElement = value; }\r
  82                 }\r
  83 #else\r
  84                 [XmlElement ("documentation")]\r
  85                 [DefaultValue ("")]\r
  86                 public string Documentation {\r
  87                         get { return documentation; }\r
  88                         set {\r
  89                                 if (value == null)\r
  90                                         documentation = String.Empty;\r
  91                                 else\r
  92                                         documentation = value;\r
  93                         }\r
  94                 }\r
  95                 \r
  96 #endif\r
  97         \r
  98                 #endregion // Properties\r
  99         }\r
 100 }\r