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 \r
  10 //\r
  11 // Permission is hereby granted, free of charge, to any person obtaining\r
  12 // a copy of this software and associated documentation files (the\r
  13 // "Software"), to deal in the Software without restriction, including\r
  14 // without limitation the rights to use, copy, modify, merge, publish,\r
  15 // distribute, sublicense, and/or sell copies of the Software, and to\r
  16 // permit persons to whom the Software is furnished to do so, subject to\r
  17 // the following conditions:\r
  18 // \r
  19 // The above copyright notice and this permission notice shall be\r
  20 // included in all copies or substantial portions of the Software.\r
  21 // \r
  22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,\r
  23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\r
  24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\r
  25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\r
  26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\r
  27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\r
  28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
  29 //\r
  30 \r
  31 using System.ComponentModel;\r
  32 using System.Runtime.InteropServices;\r
  33 using System.Xml.Serialization;\r
  34 using System.Xml;\r
  35 \r
  36 namespace System.Web.Services.Description {\r
  37         public abstract class DocumentableItem {\r
  38 \r
  39                 #region Fields\r
  40 \r
  41                 XmlElement docElement;\r
  42 \r
  43 #if NET_2_0\r
  44                 XmlAttribute [] extAttributes;\r
  45                 XmlSerializerNamespaces namespaces;\r
  46 #endif\r
  47 \r
  48                 #endregion // Fields\r
  49 \r
  50                 #region Constructors\r
  51 \r
  52                 protected DocumentableItem ()\r
  53                 {\r
  54                 }\r
  55                 \r
  56                 #endregion // Constructors\r
  57 \r
  58                 #region Properties\r
  59 \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                 [ComVisible (false)]\r
  78                 [XmlAnyElement (Name="documentation", Namespace="http://schemas.xmlsoap.org/wsdl/")]\r
  79                 public XmlElement DocumentationElement\r
  80                 {\r
  81                         get { return docElement; }\r
  82                         set { docElement = value; }\r
  83                 }\r
  84 \r
  85 #if NET_2_0\r
  86                 [XmlAnyAttribute]\r
  87                 public XmlAttribute [] ExtensibleAttributes {\r
  88                         get { return extAttributes; }\r
  89                         set { extAttributes = value; }\r
  90                 }\r
  91 \r
  92                 [XmlIgnore]\r
  93                 public abstract ServiceDescriptionFormatExtensionCollection Extensions {\r
  94                         get;\r
  95                 }\r
  96 \r
  97                 [XmlNamespaceDeclarations]\r
  98                 public XmlSerializerNamespaces Namespaces {\r
  99                         get { \r
 100                                 if (namespaces == null)\r
 101                                         namespaces = new XmlSerializerNamespaces ();\r
 102                                 return namespaces;\r
 103                         }\r
 104                         set { namespaces = value; }\r
 105                 }\r
 106 #endif\r
 107 \r
 108                 #endregion // Properties\r
 109         }\r
 110 }\r