mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 3.6.0

Browse Source 
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
This commit is contained in:
Jo Shields
2014-08-13 10:39:27 +01:00
commit a575963da9
50588 changed files with 8155799 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeExporter.xml Normal file
View File

@@ -0,0 +1,51 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeExporter" FullName="System.Xml.Serialization.CodeExporter">
<TypeSignature Language="C#" Value="public abstract class CodeExporter" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit CodeExporter extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Concrete implementations of this class include <see cref="T:System.Xml.Serialization.XmlCodeExporter" /> and <see cref="T:System.Xml.Serialization.SoapCodeExporter" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents a class that can generate proxy code from an XML representation of a data structure.</para>
</summary>
</Docs>
<Members>
<Member MemberName="IncludeMetadata">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeAttributeDeclarationCollection IncludeMetadata { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.CodeDom.CodeAttributeDeclarationCollection IncludeMetadata" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeAttributeDeclarationCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Using this property, you can dynamically add attributes to exported proxy code.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of code attribute metadata that is included when the code is exported.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

190
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeGenerationOptions.xml Normal file
View File

@@ -0,0 +1,190 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeGenerationOptions" FullName="System.Xml.Serialization.CodeGenerationOptions">
<TypeSignature Language="C#" Value="public enum CodeGenerationOptions" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed CodeGenerationOptions extends System.Enum" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Flags</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A Web Service Description Language (WSDL) file typically describes a class in XML schema language as an xsd:complex type composed of various primitive xsd:complex and xsd:simple types. When generating a .NET Framework class that represents a given xsd:complex type, you must choose how to represent the various primitive types it contains.</para>
<para>By default, each primitive is implemented as a field. If you specify the <see cref="F:System.Xml.Serialization.CodeGenerationOptions.GenerateProperties" /> option, each primitive type is instead implemented as a property.</para>
<format type="text/html">
<h2>Ordering of Serialization Code</h2>
</format>
<para>The <see cref="F:System.Xml.Serialization.CodeGenerationOptions.GenerateOrder" /> member instructs the code generator to create the serialization code in a specific order as determined by the Order property of the following attributes:</para>
<para>
<dynamicLink>
<keyword>T:System.Xml.Serialization.XmlAnyElementAttribute </keyword>
<keyword>T:System.Xml.Serialization.XmlArrayAttribute </keyword>
<keyword>T:System.Xml.Serialization.XmlElementAttribute </keyword>
</dynamicLink>
</para>
<block subset="none" type="note">
<para>Once the Order property has been set on one public property or field in a type, it must be applied to all public properties and fields for that type and all inherited types.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies various options to use when generating .NET Framework types for use with an XML Web Service.</para>
</summary>
</Docs>
<Members>
<Member MemberName="EnableDataBinding">
<MemberSignature Language="C#" Value="EnableDataBinding" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Xml.Serialization.CodeGenerationOptions EnableDataBinding = int32(16)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Xml.Serialization.XmlEnum("enableDataBinding")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeGenerationOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Enables data binding.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GenerateNewAsync">
<MemberSignature Language="C#" Value="GenerateNewAsync" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Xml.Serialization.CodeGenerationOptions GenerateNewAsync = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Xml.Serialization.XmlEnum("newAsync")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeGenerationOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates events for the asynchronous invocation of Web methods.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GenerateOldAsync">
<MemberSignature Language="C#" Value="GenerateOldAsync" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Xml.Serialization.CodeGenerationOptions GenerateOldAsync = int32(4)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Xml.Serialization.XmlEnum("oldAsync")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeGenerationOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates Begin and End methods for the asynchronous invocation of Web methods.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GenerateOrder">
<MemberSignature Language="C#" Value="GenerateOrder" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Xml.Serialization.CodeGenerationOptions GenerateOrder = int32(8)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Xml.Serialization.XmlEnum("order")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeGenerationOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates explicitly ordered serialization code as specified through the Order property of the <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" />, <see cref="T:System.Xml.Serialization.XmlArrayAttribute" />, and <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> attributes. </para>
</summary>
</Docs>
</Member>
<Member MemberName="GenerateProperties">
<MemberSignature Language="C#" Value="GenerateProperties" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Xml.Serialization.CodeGenerationOptions GenerateProperties = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Xml.Serialization.XmlEnum("properties")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeGenerationOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents primitive types by properties.</para>
</summary>
</Docs>
</Member>
<Member MemberName="None">
<MemberSignature Language="C#" Value="None" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Xml.Serialization.CodeGenerationOptions None = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Xml.Serialization.XmlIgnore</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeGenerationOptions</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents primitive types by fields and primitive types by <see cref="N:System" /> namespace types.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

153
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifier.xml Normal file
View File

@@ -0,0 +1,153 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeIdentifier" FullName="System.Xml.Serialization.CodeIdentifier">
<TypeSignature Maintainer="auto" Language="C#" Value="public class CodeIdentifier" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit CodeIdentifier extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The methods of the <see cref="T:System.Xml.Serialization.CodeIdentifier" /> class are used by the XML serialization infrastructure while producing .NET Framework types from XML element and data type definitions. XML element or attribute names typically provide the methods' input text.</para>
<para>You do not need to call the methods of the <see cref="T:System.Xml.Serialization.CodeIdentifier" /> class directly from your code. Instead, use the various tools and APIs provided by the .NET Framework for XML serialization, such as the <see cref="T:System.Xml.Serialization.XmlSerializer" />, or the <format type="text/html"><a href="a6e6e65c-347f-4494-9457-653bf29baac2">XML Schema Definition Tool (Xsd.exe)</a></format> tool.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides static methods to convert input text into names for code entities.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeIdentifier ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete("Design mistake. It only contains static methods.")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.CodeIdentifier" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="MakeCamel">
<MemberSignature Language="C#" Value="public static string MakeCamel (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig string MakeCamel(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.CodeIdentifier.MakeCamel(System.String)" /> method converts the initial character from an upper-case to lower-case letter, if necessary.</para>
<para>You do not need to call this method directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Produces a camel-case string from an input string. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A camel-case version of the parameter string.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name of a code entity, such as a method parameter, typically taken from an XML element or attribute name.</param>
</Docs>
</Member>
<Member MemberName="MakePascal">
<MemberSignature Language="C#" Value="public static string MakePascal (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig string MakePascal(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.CodeIdentifier.MakePascal(System.String)" /> method converts the initial character from a lower-case to upper-case letter, if necessary.</para>
<para>You do not need to call this method directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Produces a Pascal-case string from an input string. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A Pascal-case version of the parameter string.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name of a code entity, such as a method parameter, typically taken from an XML element or attribute name.</param>
</Docs>
</Member>
<Member MemberName="MakeValid">
<MemberSignature Language="C#" Value="public static string MakeValid (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig string MakeValid(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.CodeIdentifier.MakeValid(System.String)" /> method removes any characters that cannot appear in a code identifier. It returns the string "Item" if no characters are valid. It prefixes the string "Item" to an input that begins with an invalid start character, for example, a digit, or a currency symbol.</para>
<para>You do not need to call this method directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Produces a valid code entity name from an input string. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string that can be used as a code identifier, such as the name of a method parameter.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name of a code entity, such as a method parameter, typically taken from an XML element or attribute name.</param>
</Docs>
</Member>
</Members>
</Type>

426
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifiers.xml Normal file
View File

@@ -0,0 +1,426 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeIdentifiers" FullName="System.Xml.Serialization.CodeIdentifiers">
<TypeSignature Maintainer="auto" Language="C#" Value="public class CodeIdentifiers" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit CodeIdentifiers extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The following list identifies tools and classes that use the <see cref="T:System.Xml.Serialization.CodeIdentifiers" />: </para>
<list type="bullet">
<item>
<para>The <format type="text/html"><a href="b9210348-8bc2-4367-8c91-d1a04b403e88">Web Services Description Language Tool (Wsdl.exe)</a></format>, or the <see cref="T:System.Web.Services.Description.ServiceDescriptionImporter" /> class, while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document.</para>
</item>
<item>
<para>The <format type="text/html"><a href="a6e6e65c-347f-4494-9457-653bf29baac2">XML Schema Definition Tool (Xsd.exe)</a></format> tool while generating classes from XML Schema Definition (XSD) documents.</para>
</item>
<item>
<para>The <see cref="T:System.Web.Services.Description.ServiceDescriptionReflector" /> class while creating <see cref="T:System.Web.Services.Description.ServiceDescription" /> objects from classes that are identified as Web services via the <see cref="T:System.Web.Services.WebServiceAttribute" /> attribute.</para>
</item>
</list>
<para>Instead of using the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class directly, use the aforementioned tools or classes. If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes.</para>
<para>Depending on its scope, a <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance can be used to maintain the names of any of the items in the following list:</para>
<list type="bullet">
<item>
<para>Types, methods, or fields. </para>
</item>
<item>
<para>The parameters and return value of a method corresponding to WSDL input and output messages.</para>
</item>
<item>
<para>Objects within a <see cref="T:System.Web.Services.Description.ServiceDescription" /> instance that can be serialized to a WSDL document. </para>
</item>
</list>
<para>Typically, the class is used to avoid naming collisions between code entities within a particular scope, including collisions with the name of a containing entity.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Maintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeIdentifiers ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeIdentifiers (bool caseSensitive);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(bool caseSensitive) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="caseSensitive" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class and determines whether code identifiers are case sensitive.</para>
</summary>
<param name="caseSensitive">
<attribution license="cc4" from="Microsoft" modified="false" />true if identifiers are case sensitive; otherwise, false. </param>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (string identifier, object value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(string identifier, object value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Unlike the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method, the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" /> method does not prevent naming collisions.</para>
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a named code entity or type mapping to the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
</summary>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />A name that is used to index the code entity.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The code entity or type mapping information.</param>
</Docs>
</Member>
<Member MemberName="AddReserved">
<MemberSignature Language="C#" Value="public void AddReserved (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddReserved(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A reserved name can belong to a containing code entity, such as a type for which member names must also be generated.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Prevents a specified name from being used within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
</summary>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />A name that will not be available within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /><ui> </ui>instance's scope.</param>
</Docs>
</Member>
<Member MemberName="AddUnique">
<MemberSignature Language="C#" Value="public string AddUnique (string identifier, object value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance string AddUnique(string identifier, object value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the identifier parameter value is not unique within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope, a new, unique string is generated and used in its place. The new string is generated by appending to the input name. The original name is not unique if it was passed previously to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" />, <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" />, or <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" /> method, or if it was generated by a previous call to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method. In each case, if the new identifier is not unique, it is first passed to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.MakeUnique(System.String)" /> method to create a new unique identifier.</para>
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a named code entity or type mapping to the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope, ensuring that the name is unique within the scope. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The identifier parameter value or a modified string if there is a name collision.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />A candidate name that is used to index the code entity.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The code entity or type mapping information.</param>
</Docs>
</Member>
<Member MemberName="Clear">
<MemberSignature Language="C#" Value="public void Clear ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Clear() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reserved names, as added through the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" /> method, are not removed.</para>
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes all code entities or type mappings, including their names, from the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
</summary>
</Docs>
</Member>
<Member MemberName="IsInUse">
<MemberSignature Language="C#" Value="public bool IsInUse (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool IsInUse(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The input name is not unique if it was passed previously to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" />, <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" />, or <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" /> method, or if it was generated by the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method.</para>
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether a specified name is already being used within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the name is already in use; otherwise, false.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name to check for use within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope.</param>
</Docs>
</Member>
<Member MemberName="MakeRightCase">
<MemberSignature Language="C#" Value="public string MakeRightCase (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance string MakeRightCase(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the value of the <see cref="P:System.Xml.Serialization.CodeIdentifiers.UseCamelCasing" /> property is true and the first character of the input is a letter, it is made lowercase, if necessary. If the value of the <see cref="P:System.Xml.Serialization.CodeIdentifiers.UseCamelCasing" /> is false, Pascal case is in effect and the first character, if a letter, is capitalized, if necessary.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Ensures that the input is of the correct case by modifying the name according to the value of the <see cref="P:System.Xml.Serialization.CodeIdentifiers.UseCamelCasing" /> property. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string that is the same as the input identifier or has the first letter's case modified.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name to possibly modify.</param>
</Docs>
</Member>
<Member MemberName="MakeUnique">
<MemberSignature Language="C#" Value="public string MakeUnique (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance string MakeUnique(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The input name is not unique if it was passed previously to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" />, <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" />, or <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" /> method, or if it was generated by the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method. If the name is not unique, a new string is generated by appending to the original string.</para>
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the input name conflicts with another name within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope and, if it does, generates a modified string. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The identifier parameter value or a modified string if there is a name collision.</para>
</returns>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name to modify if it is not already unique.</param>
</Docs>
</Member>
<Member MemberName="Remove">
<MemberSignature Language="C#" Value="public void Remove (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Remove(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes from the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope the code entity or type mapping identified by the input name. </para>
</summary>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the code entity or type mapping information to remove.</param>
</Docs>
</Member>
<Member MemberName="RemoveReserved">
<MemberSignature Language="C#" Value="public void RemoveReserved (string identifier);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void RemoveReserved(string identifier) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="identifier" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes the input name from the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's reserved names. </para>
</summary>
<param name="identifier">
<attribution license="cc4" from="Microsoft" modified="false" />A name that will be made available within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope.</param>
</Docs>
</Member>
<Member MemberName="ToArray">
<MemberSignature Language="C#" Value="public object ToArray (Type type);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance object ToArray(class System.Type type) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an array of the code entities or type mappings within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An array of the code entities or type mappings that is stored by the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> object.</para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The type of all the code entities or type mappings for the instance.</param>
</Docs>
</Member>
<Member MemberName="UseCamelCasing">
<MemberSignature Language="C#" Value="public bool UseCamelCasing { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool UseCamelCasing" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'bool'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>With camel case, if the first character of an identifier is a letter, it must be lowercase. With Pascal case, if the first character is a letter, it must be uppercase.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that indicates whether the instance uses camel case. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

118
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/IXmlSerializable.xml Normal file
View File

@@ -0,0 +1,118 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IXmlSerializable" FullName="System.Xml.Serialization.IXmlSerializable">
<TypeSignature Maintainer="auto" Language="C#" Value="public interface IXmlSerializable" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IXmlSerializable" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>There are two reasons to implement this interface. The first is to control how your object is serialized or deserialized by the <see cref="T:System.Xml.Serialization.XmlSerializer" />. For example, you can chunk data into bytes instead of buffering large data sets, and also avoid the inflation that occurs when the data is encoded using Base64 encoding. To control the serialization, implement the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> and <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> methods to control the <see cref="T:System.Xml.XmlReader" /> and <see cref="T:System.Xml.XmlWriter" /> classes used to read and write the XML. For an example of this, see <format type="text/html"><a href="22f1b818-7e0d-428a-8680-f17d6ebdd185">How To: Chunk Serialized Data</a></format>.</para>
<para>The second reason is to be able to control the schema. To enable this, you must apply the <see cref="T:System.Xml.Serialization.XmlSchemaProviderAttribute" /> to the serializable type, and specify the name of the static member that returns the schema. See the <see cref="T:System.Xml.Serialization.XmlSchemaProviderAttribute" /> for an example.</para>
<para>A class that implements the interface must have a parameterless constructor. This is a requirement of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides custom formatting for XML serialization and deserialization.</para>
</summary>
</Docs>
<Members>
<Member MemberName="GetSchema">
<MemberSignature Language="C#" Value="public System.Xml.Schema.XmlSchema GetSchema ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Xml.Schema.XmlSchema GetSchema() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Schema.XmlSchema</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When serializing or deserializing an object, the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class does not perform XML validation. For this reason, it is often safe to omit schema information by providing a trivial implementation of this method, for example by returning null (Nothing in Visual Basic).</para>
<para>If providing schema information is necessary, you should use the <see cref="T:System.Xml.Serialization.XmlSchemaProviderAttribute" /> attribute. The GetSchema method should still return null (or Nothing).</para>
<para>Some dnprdnshort types as well as legacy custom types implementing the IXmlSerializable interface may be using GetSchema instead of XmlSchemaProvider. In this case, the method returns an accurate XML schema that describes the XML representation of the object generated by the <see cref="M:System.Data.DataSet.WriteXml" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is reserved and should not be used. When implementing the IXmlSerializable interface, you should return null (Nothing in Visual Basic) from this method, and instead, if specifying a custom schema is required, apply the <see cref="T:System.Xml.Serialization.XmlSchemaProviderAttribute" /> to the class.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Xml.Schema.XmlSchema" /> that describes the XML representation of the object that is produced by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and consumed by the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
</returns>
</Docs>
</Member>
<Member MemberName="ReadXml">
<MemberSignature Language="C#" Value="public void ReadXml (System.Xml.XmlReader reader);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void ReadXml(class System.Xml.XmlReader reader) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlReader" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method must reconstitute your object using the information that was written by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method.</para>
<para>When this method is called, the reader is positioned on the start tag that wraps the information for your type. That is, directly on the start tag that indicates the beginning of a serialized object. When this method returns, it must have read the entire element from beginning to end, including all of its contents. Unlike the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method, the framework does not handle the wrapper element automatically. Your implementation must do so. Failing to observe these positioning rules may cause code to generate unexpected runtime exceptions or corrupt data.</para>
<para>When implementing this method, you should consider the possibility that a malicious user might provide a well-formed but invalid XML representation in order to disable or otherwise alter the behavior of your application.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates an object from its XML representation.</para>
</summary>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> stream from which the object is deserialized. </param>
</Docs>
</Member>
<Member MemberName="WriteXml">
<MemberSignature Language="C#" Value="public void WriteXml (System.Xml.XmlWriter writer);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteXml(class System.Xml.XmlWriter writer) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlWriter" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> implementation you provide should write out the XML representation of the object. The framework writes a wrapper element and positions the XML writer after its start. Your implementation may write its contents, including child elements. The framework then closes the wrapper element.</para>
<para>Write sufficient information to the <see cref="T:System.Xml.XmlWriter" /> stream to allow the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method to reconstitute your object.</para>
<para>For example, if your object state includes an array variable, be sure to write the length of the array, or use a parent element to contain the elements that describe the array values, so that you know how many values to read when the object is reconstituted.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Converts an object into its XML representation.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlWriter" /> stream to which the object is serialized. </param>
</Docs>
</Member>
</Members>
</Type>

72
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/IXmlTextParser.xml Normal file
View File

@@ -0,0 +1,72 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IXmlTextParser" FullName="System.Xml.Serialization.IXmlTextParser">
<TypeSignature Language="C#" Value="public interface IXmlTextParser" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IXmlTextParser" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not implement the <see cref="T:System.Xml.Serialization.IXmlTextParser" /> interface in your code. Instead use the <see cref="P:System.Xml.XmlTextReader.Normalization" /> property of the <see cref="T:System.Xml.XmlTextReader" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Establishes a <see cref="P:System.Xml.Serialization.IXmlTextParser.Normalized" /> property for use by the .NET Framework infrastructure.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Normalized">
<MemberSignature Language="C#" Value="public bool Normalized { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool Normalized" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not implement the <see cref="T:System.Xml.Serialization.IXmlTextParser" /> interface and <see cref="P:System.Xml.Serialization.IXmlTextParser.Normalized" /> property in your code. Instead use the <see cref="P:System.Xml.XmlTextReader.Normalization" /> property of the <see cref="T:System.Xml.XmlTextReader" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets whether white space and attribute values are normalized.</para>
</summary>
</Docs>
</Member>
<Member MemberName="WhitespaceHandling">
<MemberSignature Language="C#" Value="public System.Xml.WhitespaceHandling WhitespaceHandling { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Xml.WhitespaceHandling WhitespaceHandling" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.WhitespaceHandling</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not implement the <see cref="T:System.Xml.Serialization.IXmlTextParser" /> interface and <see cref="P:System.Xml.Serialization.IXmlTextParser.Normalized" /> property in your code. Instead use the <see cref="P:System.Xml.XmlTextReader.Normalization" /> property of the <see cref="T:System.Xml.XmlTextReader" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets how white space is handled when parsing XML.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

112
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/ImportContext.xml Normal file
View File

@@ -0,0 +1,112 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ImportContext" FullName="System.Xml.Serialization.ImportContext">
<TypeSignature Language="C#" Value="public class ImportContext" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ImportContext extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Describes the context in which a set of schema is bound to .NET Framework code entities.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ImportContext (System.Xml.Serialization.CodeIdentifiers identifiers, bool shareTypes);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.CodeIdentifiers identifiers, bool shareTypes) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="identifiers" Type="System.Xml.Serialization.CodeIdentifiers" />
<Parameter Name="shareTypes" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.ImportContext" /> class for the given code identifiers, with the given type-sharing option.</para>
</summary>
<param name="identifiers">
<attribution license="cc4" from="Microsoft" modified="false" />The code entities to which the context applies.</param>
<param name="shareTypes">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Boolean" /> value that determines whether custom types are shared among schema.</param>
</Docs>
</Member>
<Member MemberName="ShareTypes">
<MemberSignature Language="C#" Value="public bool ShareTypes { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool ShareTypes" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that determines whether custom types are shared.</para>
</summary>
</Docs>
</Member>
<Member MemberName="TypeIdentifiers">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.CodeIdentifiers TypeIdentifiers { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.CodeIdentifiers TypeIdentifiers" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.CodeIdentifiers</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a set of code entities to which the context applies.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Warnings">
<MemberSignature Language="C#" Value="public System.Collections.Specialized.StringCollection Warnings { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Specialized.StringCollection Warnings" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Specialized.StringCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of warnings that are generated when importing the code entity descriptions.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

51
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SchemaImporter.xml Normal file
View File

@@ -0,0 +1,51 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SchemaImporter" FullName="System.Xml.Serialization.SchemaImporter">
<TypeSignature Language="C#" Value="public abstract class SchemaImporter" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit SchemaImporter extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This class describes a schema importer, which transforms an XML schema into corresponding code entities. The <see cref="T:System.Xml.Serialization.SchemaImporter" /> class is the parent class of the <see cref="T:System.Xml.Serialization.XmlSchemaImporter" /> class, which implements this functionality.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Describes a schema importer.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Extensions">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.Advanced.SchemaImporterExtensionCollection Extensions { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.Advanced.SchemaImporterExtensionCollection Extensions" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.Advanced.SchemaImporterExtensionCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Schema importer extensions modify the behavior of <see cref="T:System.Xml.Serialization.XmlSchemaImporter" /> objects. By adding <see cref="T:System.Xml.Serialization.Advanced.SchemaImporterExtension" /> objects to this collection, you can customize the code generated by specific schema patterns.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of schema importer extensions.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

576
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapAttributeAttribute.xml Normal file
View File

File diff suppressed because it is too large Load Diff

189
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapAttributeOverrides.xml Normal file
View File

@@ -0,0 +1,189 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapAttributeOverrides" FullName="System.Xml.Serialization.SoapAttributeOverrides">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapAttributeOverrides" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapAttributeOverrides extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class enables an <see cref="T:System.Xml.Serialization.XmlSerializer" /> to override the default way of serializing a set of objects. Overriding serialization in this way has two uses: first, you can control and augment the serialization of objects found in a DLL, even if you do not have access to the source; second, you can create one set of serializable classes, but serialize the objects in multiple ways. For example, instead of serializing members of a class instance as XML elements, you can serialize them as XML attributes, resulting in a more efficient document to transport.</para>
<para>After you create a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />, you create an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> using the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class. Pass the resulting object as an argument to the <see cref="M:System.Xml.Serialization.XmlSerializer.#ctor" /> constructor. The resulting <see cref="T:System.Xml.Serialization.XmlSerializer" /> uses the data contained by the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> to override attributes that control how objects are serialized. To accomplish this, the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> contains a collection of the object types that are overridden, as well as a <see cref="T:System.Xml.Serialization.SoapAttributes" /> associated with each overridden object type. Each <see cref="T:System.Xml.Serialization.SoapAttributes" /> contains an appropriate set of attribute objects that control how each field, property, or class is serialized.</para>
<para>The process for creating and using a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> is as follows: </para>
<list type="ordered">
<item>
<para>Create a <see cref="T:System.Xml.Serialization.SoapAttributes" />.</para>
</item>
<item>
<para>Create an attribute object that is appropriate to the object being overridden. For example, to override a field or property, create a <see cref="T:System.Xml.Serialization.SoapElementAttribute" />, using the new, derived type. You can optionally assign a new <see cref="P:System.Xml.Serialization.SoapElementAttribute.ElementName" /> that overrides the base class's attribute name or namespace.</para>
</item>
<item>
<para>Add the attribute object to the appropriate <see cref="T:System.Xml.Serialization.SoapAttributes" /> property or collection. For example, you would set the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapElement" /> property of the <see cref="T:System.Xml.Serialization.SoapAttributes" /> object to the <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> and specify the member name that is being overridden.</para>
</item>
<item>
<para>Create a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />.</para>
</item>
<item>
<para>Add the <see cref="T:System.Xml.Serialization.SoapAttributes" /> to the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> using the <see cref="M:System.Xml.Serialization.XmlAttributeOverrides.Add(System.Type,System.Xml.Serialization.XmlAttributes)" /> method. If the object being overridden is a <see cref="T:System.Xml.Serialization.SoapTypeAttribute" />, you need only specify the type of the overridden object. But if you are overriding a field or property, you must also specify the name of the overridden member.</para>
</item>
<item>
<para>Create an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> using the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class.</para>
</item>
<item>
<para>When constructing the <see cref="T:System.Xml.Serialization.XmlSerializer" />, pass the <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> to the <see cref="M:System.Xml.Serialization.XmlSerializer.#ctor" /> constructor.</para>
</item>
<item>
<para>Use the resulting <see cref="T:System.Xml.Serialization.XmlSerializer" /> to serialize or deserialize the class objects.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows you to override attributes applied to properties, fields, and classes when you use an <see cref="T:System.Xml.Serialization.XmlSerializer" /> to serialize or deserialize an object as encoded SOAP.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapAttributeOverrides ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (Type type, System.Xml.Serialization.SoapAttributes attributes);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(class System.Type type, class System.Xml.Serialization.SoapAttributes attributes) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="attributes" Type="System.Xml.Serialization.SoapAttributes" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapAttributes" /> contains a union of attribute objects that cause the <see cref="T:System.Xml.Serialization.XmlSerializer" /> to override its default serialization behavior for a set of objects. You choose the attribute objects to place in the <see cref="T:System.Xml.Serialization.SoapAttributes" />, depending on the particular behaviors you want to override. For example, the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes a class member as an XML element by default. If you want the member to be serialized as an XML attribute instead, you would create a <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" />, assign it to the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapAttribute" /> property of a <see cref="T:System.Xml.Serialization.SoapAttributes" />, and add the <see cref="T:System.Xml.Serialization.XmlAttributes" /> to the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />. Use the <see cref="M:System.Xml.Serialization.SoapAttributeOverrides.Add(System.Type,System.Xml.Serialization.SoapAttributes)" /> method to add the <see cref="T:System.Xml.Serialization.SoapAttributes" /> to the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />.</para>
<para>Use this overload to add a <see cref="T:System.Xml.Serialization.SoapAttributes" /> that contains a <see cref="T:System.Xml.Serialization.SoapTypeAttribute" />. Because the <see cref="T:System.Xml.Serialization.SoapTypeAttribute" /> overrides the serialization of a class, you need not specify a member of the class to override, only the type of the class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a <see cref="T:System.Xml.Serialization.SoapAttributes" /> to a collection of <see cref="T:System.Xml.Serialization.SoapAttributes" /> objects. The <paramref name="type" /> parameter specifies an object to be overridden by the <see cref="T:System.Xml.Serialization.SoapAttributes" />.</para>
</summary>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the object that is overridden. </param>
<param name="attributes">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.SoapAttributes" /> that represents the overriding attributes. </param>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (Type type, string member, System.Xml.Serialization.SoapAttributes attributes);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(class System.Type type, string member, class System.Xml.Serialization.SoapAttributes attributes) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="member" Type="System.String" />
<Parameter Name="attributes" Type="System.Xml.Serialization.SoapAttributes" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapAttributes" /> contains a union of attribute objects that cause the <see cref="T:System.Xml.Serialization.XmlSerializer" /> to override its default serialization behavior for a set of objects. You choose the attribute objects to place in the <see cref="T:System.Xml.Serialization.SoapAttributes" />, depending on the particular behaviors you want to override. For example, the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes a class member as an XML element by default. If you want the member to be serialized as a SOAP attribute instead, you would create a <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" />, assign it to the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapAttribute" /> property of a <see cref="T:System.Xml.Serialization.SoapAttributes" />, and add the <see cref="T:System.Xml.Serialization.XmlAttributes" /> to the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />. Use the <see cref="M:System.Xml.Serialization.SoapAttributeOverrides.Add(System.Type,System.Xml.Serialization.SoapAttributes)" /> method to add the <see cref="T:System.Xml.Serialization.SoapAttributes" /> to the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />.</para>
<para>Use this method when the <see cref="T:System.Xml.Serialization.SoapAttributes" /> contains either a <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" />, <see cref="T:System.ComponentModel.DefaultValueAttribute" /> <see cref="T:System.Xml.Serialization.SoapElementAttribute" />, <see cref="T:System.Xml.Serialization.SoapEnumAttribute" />, or <see cref="T:System.Xml.Serialization.SoapIgnoreAttribute" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a <see cref="T:System.Xml.Serialization.SoapAttributes" /> to the collection of <see cref="T:System.Xml.Serialization.SoapAttributes" /> objects contained by the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />. The <paramref name="type" /> parameter specifies the object to be overridden by the <see cref="T:System.Xml.Serialization.SoapAttributes" />. The <paramref name="member" /> parameter specifies the name of a member that is overridden.</para>
</summary>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the object to override. </param>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the member to override. </param>
<param name="attributes">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.SoapAttributes" /> that represents the overriding attributes. </param>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.SoapAttributes this[Type type] { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.SoapAttributes Item(class System.Type)" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.SoapAttributes</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
</Parameters>
<Docs>
<param name="type">To be added.</param>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.SoapAttributes this[Type type, string member] { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.SoapAttributes Item(class System.Type, string)" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.SoapAttributes</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="member" Type="System.String" />
</Parameters>
<Docs>
<param name="type">To be added.</param>
<param name="member">To be added.</param>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
</Type>

231
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapAttributes.xml Normal file
View File

@@ -0,0 +1,231 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapAttributes" FullName="System.Xml.Serialization.SoapAttributes">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapAttributes" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapAttributes extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creating a <see cref="T:System.Xml.Serialization.SoapAttributes" /> is part of a process that overrides the default way the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes class instances. For example, suppose you want to serialize an object that is created from a DLL that has an inaccessible source. By using the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class, you can augment or otherwise control how the object is serialized.</para>
<para>The members of the <see cref="T:System.Xml.Serialization.SoapAttributes" /> class correspond directly to a family of attribute classes that control serialization. For example, the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapAttribute" /> property must be set to a <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" />, which allows you to override serialization of a field or property by instructing the <see cref="T:System.Xml.Serialization.XmlSerializer" /> to serialize the property value as an encoded SOAP attribute. For a complete list of attributes that control encoded SOAP serialization, see <format type="text/html"><a href="93EE258C-9C0F-4A08-897C-C10DB7A00F91">[&lt;topic://cpconAttributesThatControlSOAPEncodedSerialization&gt;]</a></format>.</para>
<para>For more details about adding an instance of the <see cref="T:System.Xml.Serialization.SoapAttributes" /> class to an instance of the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents a collection of attribute objects that control how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes and deserializes SOAP methods.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapAttributes ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For each member or class instance whose serialization is being overridden, you must create a new <see cref="T:System.Xml.Serialization.SoapAttributes" />. Set the properties for the <see cref="T:System.Xml.Serialization.SoapAttributes" /> as appropriate to the member or object, then add the <see cref="T:System.Xml.Serialization.SoapAttributes" /> to an instance of the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapAttributes" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapAttributes (System.Reflection.ICustomAttributeProvider provider);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Reflection.ICustomAttributeProvider provider) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="provider" Type="System.Reflection.ICustomAttributeProvider" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapAttributes" /> class using the specified custom type.</para>
</summary>
<param name="provider">
<attribution license="cc4" from="Microsoft" modified="false" />Any object that implements the <see cref="T:System.Reflection.ICustomAttributeProvider" /> interface, such as the <see cref="T:System.Type" /> class.</param>
</Docs>
</Member>
<Member MemberName="SoapAttribute">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.SoapAttributeAttribute SoapAttribute { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.SoapAttributeAttribute SoapAttribute" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.SoapAttributeAttribute</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'SoapAttributeAttribute'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, if no attribute is applied to a public field or public read/write property, it is serialized as an XML element. You can also instruct the <see cref="T:System.Xml.Serialization.XmlSerializer" /> to serialize a member as an encoded SOAP XML attribute by applying a <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" /> to the field or property. (The <see cref="T:System.Xml.Serialization.XmlSerializer" /> must be created with an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> in order to serialize an object as an encoded SOAP XML stream.)</para>
<para>The <see cref="P:System.Xml.Serialization.SoapAttributes.SoapAttribute" /> property allows you to override the serialization controlled by applying a <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" /> to the member. For more details on this process, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the <see cref="T:System.Xml.Serialization.SoapAttributeAttribute" /> to override.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SoapDefaultValue">
<MemberSignature Language="C#" Value="public object SoapDefaultValue { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance object SoapDefaultValue" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'object'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default value of a member can be set by applying a <see cref="T:System.ComponentModel.DefaultValueAttribute" /> attribute to the member. If the member is being serialized as an encoded SOAP message, you can change the default value by creating a new <see cref="T:System.ComponentModel.DefaultValueAttribute" />, setting its <see cref="P:System.ComponentModel.DefaultValueAttribute.Value" /> property, and setting the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapDefaultValue" /> property to the object. Add the <see cref="T:System.Xml.Serialization.SoapAttributes" /> to a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />. For more details, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the default value of an XML element or attribute.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SoapElement">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.SoapElementAttribute SoapElement { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.SoapElementAttribute SoapElement" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.SoapElementAttribute</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'SoapElementAttribute'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> is used to control the serialization of a class member as an XML element. Set the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapElement" /> property to a new <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> to override the serialization of a class member as an XML element by creating a new <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> and assigning it to the property. Then add the <see cref="T:System.Xml.Serialization.SoapAttributes" /> to a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />. Create an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> with the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />, then construct an <see cref="T:System.Xml.Serialization.XmlSerializer" /> with the <see cref="T:System.Xml.Serialization.XmlTypeMapping" />.</para>
<para>For more information, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> to override.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SoapEnum">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.SoapEnumAttribute SoapEnum { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.SoapEnumAttribute SoapEnum" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.SoapEnumAttribute</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'SoapEnumAttribute'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> is used to control the serialization of an enumeration member. Set the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapEnum" /> property to a new <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> to override the serialization of such a member.</para>
<para>For more information, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets an object that specifies how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes a SOAP enumeration.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SoapIgnore">
<MemberSignature Language="C#" Value="public bool SoapIgnore { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool SoapIgnore" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'bool'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, all public fields and public read/write properties are serialized by the <see cref="T:System.Xml.Serialization.XmlSerializer" />. That is, the value of each public field or property is persisted as an XML element or XML attribute in an XML document.</para>
<para>To override the default serialization of a field or property, create a <see cref="T:System.Xml.Serialization.SoapAttributes" />, and set its <see cref="P:System.Xml.Serialization.SoapAttributes.SoapIgnore" /> property to true. Use the <see cref="M:System.Xml.Serialization.SoapAttributeOverrides.Add(System.Type,System.Xml.Serialization.SoapAttributes)" /> method to add the object to a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> and specify the type of the object that contains the field or property to ignore and the name of the field or property to ignore.</para>
<para>If a <see cref="T:System.Xml.Serialization.SoapIgnoreAttribute" /> is applied to a field or property, the field or property is ignored. However you can override that behavior by creating a <see cref="T:System.Xml.Serialization.SoapAttributes" />, setting its <see cref="P:System.Xml.Serialization.SoapAttributes.SoapIgnore" /> property to false, and adding it to a <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />, specifying the type of the object that contains the field or property and the name of the field or property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes a public field or property as encoded SOAP XML.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SoapType">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.SoapTypeAttribute SoapType { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.Serialization.SoapTypeAttribute SoapType" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.SoapTypeAttribute</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'SoapTypeAttribute'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapTypeAttribute" /> can be used to control the XML stream generated by the <see cref="T:System.Xml.Serialization.XmlSerializer" />. Set the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapType" /> property to a new <see cref="T:System.Xml.Serialization.SoapTypeAttribute" /> to control the schema for the XML that is generated when a class is serialized.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets an object that instructs the <see cref="T:System.Xml.Serialization.XmlSerializer" /> how to serialize an object type into encoded SOAP XML.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

327
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapCodeExporter.xml Normal file
View File

@@ -0,0 +1,327 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapCodeExporter" FullName="System.Xml.Serialization.SoapCodeExporter">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapCodeExporter : System.Xml.Serialization.CodeExporter" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapCodeExporter extends System.Xml.Serialization.CodeExporter" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Xml.Serialization.CodeExporter</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class is used by the <format type="text/html"><a href="b9210348-8bc2-4367-8c91-d1a04b403e88">Web Services Description Language Tool (Wsdl.exe)</a></format> and the <see cref="T:System.Web.Services.Description.ServiceDescriptionImporter" /> class while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of using <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> directly, use Wsdl.exe.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapCodeExporter (System.CodeDom.CodeNamespace codeNamespace);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.CodeDom.CodeNamespace codeNamespace) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="codeNamespace" Type="System.CodeDom.CodeNamespace" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instead of directly creating an instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, use the Wsdl.exe tool.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, assuming no code compile unit. </para>
</summary>
<param name="codeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeNamespace" /> that specifies the namespace of the types to generate.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapCodeExporter (System.CodeDom.CodeNamespace codeNamespace, System.CodeDom.CodeCompileUnit codeCompileUnit);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.CodeDom.CodeNamespace codeNamespace, class System.CodeDom.CodeCompileUnit codeCompileUnit) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="codeNamespace" Type="System.CodeDom.CodeNamespace" />
<Parameter Name="codeCompileUnit" Type="System.CodeDom.CodeCompileUnit" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instead of directly creating an instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, use the Wsdl.exe tool.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, specifying a code compile unit parameter in addition to a namespace parameter.</para>
</summary>
<param name="codeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeNamespace" /> that specifies the namespace of the types to generate.</param>
<param name="codeCompileUnit">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeCompileUnit" /> that identifies the program graph container to which used assembly references are automatically added.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapCodeExporter (System.CodeDom.CodeNamespace codeNamespace, System.CodeDom.CodeCompileUnit codeCompileUnit, System.Xml.Serialization.CodeGenerationOptions options);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.CodeDom.CodeNamespace codeNamespace, class System.CodeDom.CodeCompileUnit codeCompileUnit, valuetype System.Xml.Serialization.CodeGenerationOptions options) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="codeNamespace" Type="System.CodeDom.CodeNamespace" />
<Parameter Name="codeCompileUnit" Type="System.CodeDom.CodeCompileUnit" />
<Parameter Name="options" Type="System.Xml.Serialization.CodeGenerationOptions" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instead of directly creating an instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, use the Wsdl.exe tool.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, specifying a code namespace, a code compile unit, and code generation options.</para>
</summary>
<param name="codeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeNamespace" /> that specifies the namespace of the types to generate.</param>
<param name="codeCompileUnit">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeCompileUnit" /> that identifies the program graph container to which used assembly references are automatically added.</param>
<param name="options">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.CodeGenerationOptions" /> enumeration that specifies the options with which exported code is generated.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapCodeExporter (System.CodeDom.CodeNamespace codeNamespace, System.CodeDom.CodeCompileUnit codeCompileUnit, System.Xml.Serialization.CodeGenerationOptions options, System.Collections.Hashtable mappings);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.CodeDom.CodeNamespace codeNamespace, class System.CodeDom.CodeCompileUnit codeCompileUnit, valuetype System.Xml.Serialization.CodeGenerationOptions options, class System.Collections.Hashtable mappings) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="codeNamespace" Type="System.CodeDom.CodeNamespace" />
<Parameter Name="codeCompileUnit" Type="System.CodeDom.CodeCompileUnit" />
<Parameter Name="options" Type="System.Xml.Serialization.CodeGenerationOptions" />
<Parameter Name="mappings" Type="System.Collections.Hashtable" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instead of directly creating an instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, use the Wsdl.exe tool.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, specifying a code namespace, a code compile unit, code generation options, and mappings.</para>
</summary>
<param name="codeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeNamespace" /> that specifies the namespace of the types to generate.</param>
<param name="codeCompileUnit">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeCompileUnit" /> that identifies the program graph container to which used assembly references are automatically added.</param>
<param name="options">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.CodeGenerationOptions" /> enumeration that specifies the options with which exported code is generated.</param>
<param name="mappings">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.Hashtable" /> that contains <see cref="T:System.Xml.Serialization.XmlMapping" /> objects.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapCodeExporter (System.CodeDom.CodeNamespace codeNamespace, System.CodeDom.CodeCompileUnit codeCompileUnit, System.CodeDom.Compiler.CodeDomProvider codeProvider, System.Xml.Serialization.CodeGenerationOptions options, System.Collections.Hashtable mappings);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.CodeDom.CodeNamespace codeNamespace, class System.CodeDom.CodeCompileUnit codeCompileUnit, class System.CodeDom.Compiler.CodeDomProvider codeProvider, valuetype System.Xml.Serialization.CodeGenerationOptions options, class System.Collections.Hashtable mappings) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="codeNamespace" Type="System.CodeDom.CodeNamespace" />
<Parameter Name="codeCompileUnit" Type="System.CodeDom.CodeCompileUnit" />
<Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
<Parameter Name="options" Type="System.Xml.Serialization.CodeGenerationOptions" />
<Parameter Name="mappings" Type="System.Collections.Hashtable" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, specifying a code namespace, a code compile unit, a code generator, code generation options, and mappings.</para>
</summary>
<param name="codeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeNamespace" /> that specifies the namespace of the types to generate.</param>
<param name="codeCompileUnit">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeCompileUnit" /> that identifies the program graph container to which used assembly references are automatically added.</param>
<param name="codeProvider">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> that is used to create the code.</param>
<param name="options">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.CodeGenerationOptions" /> enumeration that specifies the options with which exported code is generated.</param>
<param name="mappings">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.Hashtable" /> that contains <see cref="T:System.Xml.Serialization.XmlMapping" /> objects.</param>
</Docs>
</Member>
<Member MemberName="AddMappingMetadata">
<MemberSignature Language="C#" Value="public void AddMappingMetadata (System.CodeDom.CodeAttributeDeclarationCollection metadata, System.Xml.Serialization.XmlMemberMapping member);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddMappingMetadata(class System.CodeDom.CodeAttributeDeclarationCollection metadata, class System.Xml.Serialization.XmlMemberMapping member) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="metadata" Type="System.CodeDom.CodeAttributeDeclarationCollection" />
<Parameter Name="member" Type="System.Xml.Serialization.XmlMemberMapping" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used by the Wsdl.exe tool when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Add a <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> declaration to a method parameter or return value corresponding to a part element of a SOAP message definition in a WSDL document. </para>
</summary>
<param name="metadata">
<attribution license="cc4" from="Microsoft" modified="false" />The collection of <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> objects for the generated type, to which the method adds an attribute declaration.</param>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />An internal .NET Framework type mapping for a single part of a WSDL message definition.</param>
</Docs>
</Member>
<Member MemberName="AddMappingMetadata">
<MemberSignature Language="C#" Value="public void AddMappingMetadata (System.CodeDom.CodeAttributeDeclarationCollection metadata, System.Xml.Serialization.XmlMemberMapping member, bool forceUseMemberName);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddMappingMetadata(class System.CodeDom.CodeAttributeDeclarationCollection metadata, class System.Xml.Serialization.XmlMemberMapping member, bool forceUseMemberName) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="metadata" Type="System.CodeDom.CodeAttributeDeclarationCollection" />
<Parameter Name="member" Type="System.Xml.Serialization.XmlMemberMapping" />
<Parameter Name="forceUseMemberName" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used by the Wsdl.exe tool when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a <see cref="T:System.Xml.Serialization.SoapElementAttribute" /> declaration to a method parameter or return value that corresponds to a part element of a SOAP message definition in a WSDL document. </para>
</summary>
<param name="metadata">
<attribution license="cc4" from="Microsoft" modified="false" />The collection of <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> objects for the generated type to which the method adds an attribute declaration.</param>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />An internal .NET Framework type mapping for a single part of a WSDL message definition.</param>
<param name="forceUseMemberName">
<attribution license="cc4" from="Microsoft" modified="false" />true to add an initial argument that contains the XML element name for the attribute declaration that is being generated; otherwise, false.</param>
</Docs>
</Member>
<Member MemberName="ExportMembersMapping">
<MemberSignature Language="C#" Value="public void ExportMembersMapping (System.Xml.Serialization.XmlMembersMapping xmlMembersMapping);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void ExportMembersMapping(class System.Xml.Serialization.XmlMembersMapping xmlMembersMapping) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="xmlMembersMapping" Type="System.Xml.Serialization.XmlMembersMapping" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used by the Wsdl.exe tool when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates a .NET Framework type, plus attribute declarations, for each of the parts that belong to a SOAP message definition in a WSDL document. </para>
</summary>
<param name="xmlMembersMapping">
<attribution license="cc4" from="Microsoft" modified="false" />Internal .NET Framework type mappings for the element parts of a WSDL message definition.</param>
</Docs>
</Member>
<Member MemberName="ExportTypeMapping">
<MemberSignature Language="C#" Value="public void ExportTypeMapping (System.Xml.Serialization.XmlTypeMapping xmlTypeMapping);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void ExportTypeMapping(class System.Xml.Serialization.XmlTypeMapping xmlTypeMapping) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="xmlTypeMapping" Type="System.Xml.Serialization.XmlTypeMapping" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used by the Wsdl.exe tool. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates a .NET Framework type, plus attribute declarations, for a SOAP header. </para>
</summary>
<param name="xmlTypeMapping">
<attribution license="cc4" from="Microsoft" modified="false" />Internal .NET Framework type mapping information for a SOAP header element.</param>
</Docs>
</Member>
<Member MemberName="IncludeMetadata">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeAttributeDeclarationCollection IncludeMetadata { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.CodeDom.CodeAttributeDeclarationCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'System.CodeDom.CodeAttributeDeclarationCollection'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>One or more <see cref="T:System.Xml.Serialization.XmlIncludeAttribute" /> attributes can be applied to a base type to allow one or more derived types to be serialized, depending on an object's actual type at run time.</para>
<para>Rather than use the <see cref="T:System.Xml.Serialization.SoapCodeExporter" /> class, use the Wsdl.exe tool.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of <see cref="T:System.Xml.Serialization.XmlIncludeAttribute" /> declarations, specifying derived types. </para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

572
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapElementAttribute.xml Normal file
View File

File diff suppressed because it is too large Load Diff

124
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapEnumAttribute.xml Normal file
View File

@@ -0,0 +1,124 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapEnumAttribute" FullName="System.Xml.Serialization.SoapEnumAttribute">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapEnumAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapEnumAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Field)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> class belongs to a family of attributes that controls how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes or deserializes an object as encoded SOAP XML. The resulting XML conforms to section 5 of the World Wide Web Consortium (www.w3.org) document "Simple Object Access Protocol (SOAP) 1.1". For a complete list of similar attributes, see <format type="text/html"><a href="93EE258C-9C0F-4A08-897C-C10DB7A00F91">[&lt;topic://cpconAttributesThatControlSOAPEncodedSerialization&gt;]</a></format>.</para>
<para>To serialize an object as an encoded SOAP message, you must construct the <see cref="T:System.Xml.Serialization.XmlSerializer" /> using an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> created with the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class.</para>
<para>Use the <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> to change the enumeration that the <see cref="T:System.Xml.Serialization.XmlSerializer" /> generates or recognizes (when it serializes or deserializes a class, respectively). For example, if an enumeration contains a member named One, but you prefer that the XML output be named Single, apply the <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> to the enumeration member and set the <see cref="P:System.Xml.Serialization.SoapEnumAttribute.Name" /> property to "Single".</para>
<para>You can override the <see cref="P:System.Xml.Serialization.SoapEnumAttribute.Name" /> property value of a <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> by creating an instance of the <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> class and assigning it to the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapEnum" /> property of a <see cref="T:System.Xml.Serialization.SoapAttributes" />. For details, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
<para>To serialize an object as an encoded SOAP message, you must construct the <see cref="T:System.Xml.Serialization.XmlSerializer" /> using an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> created with the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class.</para>
<block subset="none" type="note">
<para>You can use the word SoapEnum in your code instead of the longer <see cref="T:System.Xml.Serialization.SoapEnumAttribute" />.</para>
</block>
<para>For more information about using attributes, see <format type="text/html"><a href="30386922-1E00-4602-9EBF-526B271A8B87">[&lt;topic://cpconExtendingMetadataUsingAttributes&gt;]</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Controls how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes an enumeration member.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapEnumAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.Xml.Serialization.SoapEnumAttribute.#ctor" /> to override an existing enumeration. Create a new <see cref="T:System.Xml.Serialization.SoapEnumAttribute" />, set its properties and assign the object to the <see cref="P:System.Xml.Serialization.SoapAttributes.SoapEnum" /> property of a <see cref="T:System.Xml.Serialization.SoapAttributes" />. For each member of the enumeration, you must create a new <see cref="T:System.Xml.Serialization.SoapAttributes" /> and add it to the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" />. For more details, see the <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> class overview.</para>
<block subset="none" type="note">
<para>You can use the word SoapEnum in your code instead of the longer <see cref="T:System.Xml.Serialization.SoapEnumAttribute" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapEnumAttribute (string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string name) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specify the <see cref="P:System.Xml.Serialization.SoapEnumAttribute.Name" /> when you want the generated XML enumerator to differ from the enumerator found in the enumeration.</para>
<block subset="none" type="note">
<para>You can use the word SoapEnum in your code instead of the longer <see cref="T:System.Xml.Serialization.SoapEnumAttribute" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapEnumAttribute" /> class using the specified element name.</para>
</summary>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The XML element name generated by the <see cref="T:System.Xml.Serialization.XmlSerializer" />. </param>
</Docs>
</Member>
<Member MemberName="Name">
<MemberSignature Language="C#" Value="public string Name { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Name" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specify the <see cref="P:System.Xml.Serialization.SoapEnumAttribute.Name" /> when you want the generated XML enumerator to differ from the enumerator found in the enumeration.</para>
<block subset="none" type="note">
<para>You can use the word SoapEnum instead of the longer <see cref="T:System.Xml.Serialization.SoapEnumAttribute" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the value generated in an XML document when the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes an enumeration, or the value recognized when it deserializes the enumeration member.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

59
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapIgnoreAttribute.xml Normal file
View File

@@ -0,0 +1,59 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapIgnoreAttribute" FullName="System.Xml.Serialization.SoapIgnoreAttribute">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapIgnoreAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapIgnoreAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Property | System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.ReturnValue | System.AttributeTargets.All)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapIgnoreAttribute" /> class belongs to a family of attributes that controls how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes or deserializes an object as encoded SOAP XML. The resulting XML conforms to section 5 of the World Wide Web Consortium (www.w3.org) document, "Simple Object Access Protocol (SOAP) 1.1". For a complete list of similar attributes, see <format type="text/html"><a href="93EE258C-9C0F-4A08-897C-C10DB7A00F91">[&lt;topic://cpconAttributesThatControlSOAPEncodedSerialization&gt;]</a></format>.</para>
<para>To serialize an object as an encoded SOAP message, you must construct the <see cref="T:System.Xml.Serialization.XmlSerializer" /> using an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> created with the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class.</para>
<para>Apply the <see cref="T:System.Xml.Serialization.SoapIgnoreAttribute" /> to any class member that you want the <see cref="T:System.Xml.Serialization.XmlSerializer" /> to ignore when an instance of the class is serialized. For example, you may do this when the member is used to contain metadata about the object being serialized.</para>
<para>For more information about using attributes, see <format type="text/html"><a href="30386922-1E00-4602-9EBF-526B271A8B87">[&lt;topic://cpconExtendingMetadataUsingAttributes&gt;]</a></format>.</para>
<block subset="none" type="note">
<para>You can use the word SoapIgnore in your code instead of the longer <see cref="T:System.Xml.Serialization.SoapIgnoreAttribute" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instructs the <see cref="T:System.Xml.Serialization.XmlSerializer" /> not to serialize the public field or public read/write property value.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapIgnoreAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapIgnoreAttribute" /> class.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

90
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapIncludeAttribute.xml Normal file
View File

@@ -0,0 +1,90 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapIncludeAttribute" FullName="System.Xml.Serialization.SoapIncludeAttribute">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapIncludeAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapIncludeAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Method | System.AttributeTargets.Interface | System.AttributeTargets.All, AllowMultiple=true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> class belongs to a family of attributes that controls how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes, or deserializes, an object as encoded SOAP XML. The resulting XML conforms to section 5 of the World Wide Web Consortium (www.w3.org) document, "Simple Object Access Protocol (SOAP) 1.1". For a complete list of similar attributes, see <format type="text/html"><a href="93EE258C-9C0F-4A08-897C-C10DB7A00F91">[&lt;topic://cpconAttributesThatControlSOAPEncodedSerialization&gt;]</a></format>.</para>
<para>To serialize an object as an encoded SOAP message, you must construct the <see cref="T:System.Xml.Serialization.XmlSerializer" /> using an <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> created with the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class.</para>
<para>When applying the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" />, specify the <see cref="T:System.Type" /> of the derived class. When the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes objects that include both the base and the derived classes, it can then recognize both object types.</para>
<para>You can use the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> to include derived classes in service description documents that are written in the Web Services Description Language (WSDL). For example, if a method returns an <see cref="T:System.Object" />, apply the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> to the method and specify the actual types that should be returned.</para>
<para>For more information about WSDL, see World Wide Web Consortium (www.w3.org) specification, "Web Services Description Language (WSDL) 1.1".</para>
<para>For more information about using attributes, see <format type="text/html"><a href="30386922-1E00-4602-9EBF-526B271A8B87">[&lt;topic://cpconExtendingMetadataUsingAttributes&gt;]</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows the <see cref="T:System.Xml.Serialization.XmlSerializer" /> to recognize a type when it serializes or deserializes an object as encoded SOAP XML.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapIncludeAttribute (Type type);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Type type) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="type" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply multiple instances of the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> to a field or property that returns either an array of objects, an <see cref="T:System.Collections.ArrayList" /> that contains a collection of objects, or an object that can return multiple types. Set the <see cref="P:System.Xml.Serialization.SoapIncludeAttribute.Type" /> property for each type that you want the field or property to contain.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> class using the specified type.</para>
</summary>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The type of the object to include. </param>
</Docs>
</Member>
<Member MemberName="Type">
<MemberSignature Language="C#" Value="public Type Type { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Type Type" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'System.Type'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply multiple instances of the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> to a field or property that returns either an array of objects, an <see cref="T:System.Collections.ArrayList" /> that contains a collection of objects, or an object that can return multiple types. Set the <see cref="P:System.Xml.Serialization.SoapIncludeAttribute.Type" /> property for each type that you want the field or property to contain.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the type of the object to use when serializing or deserializing an object.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

481
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapReflectionImporter.xml Normal file
View File

@@ -0,0 +1,481 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapReflectionImporter" FullName="System.Xml.Serialization.SoapReflectionImporter">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapReflectionImporter" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapReflectionImporter extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class provides type mappings to SOAP-encoded message parts, as defined in a Web Services Description Language (WSDL) document. It is used only when a Web service or client specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates mappings to SOAP-encoded messages from .NET Framework types or Web service method information. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapReflectionImporter ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapReflectionImporter (string defaultNamespace);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string defaultNamespace) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="defaultNamespace" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class, specifying a default XML namespace for imported type mappings. </para>
</summary>
<param name="defaultNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />The default XML namespace to use for imported type mappings.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapReflectionImporter (System.Xml.Serialization.SoapAttributeOverrides attributeOverrides);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.SoapAttributeOverrides attributeOverrides) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="attributeOverrides" Type="System.Xml.Serialization.SoapAttributeOverrides" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class, specifying overrides for XML serialization. </para>
</summary>
<param name="attributeOverrides">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> object that overrides how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class serializes mapped types using SOAP encoding.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapReflectionImporter (System.Xml.Serialization.SoapAttributeOverrides attributeOverrides, string defaultNamespace);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.SoapAttributeOverrides attributeOverrides, string defaultNamespace) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="attributeOverrides" Type="System.Xml.Serialization.SoapAttributeOverrides" />
<Parameter Name="defaultNamespace" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> class, specifying XML serialization overrides and a default XML namespace. </para>
</summary>
<param name="attributeOverrides">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.SoapAttributeOverrides" /> object that overrides how the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class serializes mapped types using SOAP encoding.</param>
<param name="defaultNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />The default XML namespace to use for imported type mappings.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string elementName, string ns, System.Xml.Serialization.XmlReflectionMember[] members);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string elementName, string ns, class System.Xml.Serialization.XmlReflectionMember[] members) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.XmlReflectionMember[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[])" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
<para>The following list describes possible values for the <paramref name="members" /> parameter:</para>
<list type="bullet">
<item>
<para>Web service method input parameters.</para>
</item>
<item>
<para>Web service method output parameters, plus the return type, if not void, at index zero.</para>
</item>
<item>
<para>SOAP input headers.</para>
</item>
<item>
<para>SOAP output headers.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mappings for information that is gathered from a Web service method. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
</returns>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element namespace produced from the Web service method.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of .NET Framework code entities that belong to a Web service method.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string elementName, string ns, System.Xml.Serialization.XmlReflectionMember[] members, bool hasWrapperElement, bool writeAccessors);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string elementName, string ns, class System.Xml.Serialization.XmlReflectionMember[] members, bool hasWrapperElement, bool writeAccessors) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.XmlReflectionMember[]" />
<Parameter Name="hasWrapperElement" Type="System.Boolean" />
<Parameter Name="writeAccessors" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[],System.Boolean,System.Boolean)" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
<para>The following list describes possible values for the <paramref name="members" /> parameter:</para>
<list type="bullet">
<item>
<para>Web service method input parameters.</para>
</item>
<item>
<para>Web service method output parameters, plus the return type, if not void, at index zero.</para>
</item>
<item>
<para>SOAP input headers.</para>
</item>
<item>
<para>SOAP output headers.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mappings for information that is gathered from a Web service method. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
</returns>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element namespace produced from the Web service method.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of .NET Framework code entities that belong to a Web service method.</param>
<param name="hasWrapperElement">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that elements that correspond to WSDL message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, false.</param>
<param name="writeAccessors">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate an RPC-style Web service binding; false to indicate a document-style Web service binding or a SOAP header.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string elementName, string ns, System.Xml.Serialization.XmlReflectionMember[] members, bool hasWrapperElement, bool writeAccessors, bool validate);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string elementName, string ns, class System.Xml.Serialization.XmlReflectionMember[] members, bool hasWrapperElement, bool writeAccessors, bool validate) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.XmlReflectionMember[]" />
<Parameter Name="hasWrapperElement" Type="System.Boolean" />
<Parameter Name="writeAccessors" Type="System.Boolean" />
<Parameter Name="validate" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[],System.Boolean,System.Boolean,System.Boolean)" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
<para>The following list describes possible values for the <paramref name="members" /> parameter:</para>
<list type="bullet">
<item>
<para>Web service method input parameters.</para>
</item>
<item>
<para>Web service method output parameters, plus the return type, if not void, at index zero.</para>
</item>
<item>
<para>SOAP input headers.</para>
</item>
<item>
<para>SOAP output headers.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mappings for information that is gathered from a Web service method. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
</returns>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element namespace produced from the Web service method.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of .NET Framework code entities that belong to a Web service method.</param>
<param name="hasWrapperElement">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that elements that correspond to WSDL message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, false.</param>
<param name="writeAccessors">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate an RPC-style Web service binding; false to indicate a document-style Web service binding or a SOAP header.</param>
<param name="validate">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that a generated deserializer should check for the expected qualified name of the wrapper element; otherwise, false. This parameter's value is relevant only if the <paramref name="hasWrapperElement" /> parameter's value is true.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string elementName, string ns, System.Xml.Serialization.XmlReflectionMember[] members, bool hasWrapperElement, bool writeAccessors, bool validate, System.Xml.Serialization.XmlMappingAccess access);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string elementName, string ns, class System.Xml.Serialization.XmlReflectionMember[] members, bool hasWrapperElement, bool writeAccessors, bool validate, valuetype System.Xml.Serialization.XmlMappingAccess access) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="elementName" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.XmlReflectionMember[]" />
<Parameter Name="hasWrapperElement" Type="System.Boolean" />
<Parameter Name="writeAccessors" Type="System.Boolean" />
<Parameter Name="validate" Type="System.Boolean" />
<Parameter Name="access" Type="System.Xml.Serialization.XmlMappingAccess" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[])" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
<para>The following list describes possible values for the <paramref name="members" /> parameter:</para>
<list type="bullet">
<item>
<para>Web service method input parameters.</para>
</item>
<item>
<para>Web service method output parameters, plus the return type, if not void, at index zero.</para>
</item>
<item>
<para>SOAP input headers.</para>
</item>
<item>
<para>SOAP output headers.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mappings for information that is gathered from a Web service method.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
</returns>
<param name="elementName">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />An XML element namespace produced from the Web service method.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of .NET Framework code entities that belong to a Web service method.</param>
<param name="hasWrapperElement">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that elements that correspond to WSDL message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, false.</param>
<param name="writeAccessors">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate an RPC-style Web service binding; false to indicate a document-style Web service binding or a SOAP header.</param>
<param name="validate">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that a generated deserializer should check for the expected qualified name of the wrapper element; otherwise, false. This parameter's value is relevant only if the <paramref name="hasWrapperElement" /> parameter's value is true.</param>
<param name="access">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Xml.Serialization.XmlMappingAccess" /> values.</param>
</Docs>
</Member>
<Member MemberName="ImportTypeMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlTypeMapping ImportTypeMapping (Type type);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlTypeMapping ImportTypeMapping(class System.Type type) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlTypeMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The XML Schema element is serialized using SOAP encoding.</para>
<para>You do not need to call the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type)" /> method directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates a mapping to an XML Schema element for a .NET Framework type.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Internal .NET Framework mapping of a type to an XML Schema element. </para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping. </param>
</Docs>
</Member>
<Member MemberName="ImportTypeMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlTypeMapping ImportTypeMapping (Type type, string defaultNamespace);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlTypeMapping ImportTypeMapping(class System.Type type, string defaultNamespace) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlTypeMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="defaultNamespace" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The XML Schema element is serialized using SOAP encoding.</para>
<para>You do not need to call the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping(System.Type,System.String)" /> method directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates a mapping to an XML Schema element for a .NET Framework type.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Internal .NET Framework mapping of a type to an XML Schema element.</para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping. </param>
<param name="defaultNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />The default XML namespace to use.</param>
</Docs>
</Member>
<Member MemberName="IncludeType">
<MemberSignature Language="C#" Value="public void IncludeType (Type type);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void IncludeType(class System.Type type) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You do not need to call the <see cref="M:System.Xml.Serialization.SoapReflectionImporter.IncludeType(System.Type)" /> method directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Places mappings for a type in the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> instance's context for later use when import methods are invoked. </para>
</summary>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to save type mapping information.</param>
</Docs>
</Member>
<Member MemberName="IncludeTypes">
<MemberSignature Language="C#" Value="public void IncludeTypes (System.Reflection.ICustomAttributeProvider provider);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void IncludeTypes(class System.Reflection.ICustomAttributeProvider provider) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="provider" Type="System.Reflection.ICustomAttributeProvider" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Places mappings for derived types in the <see cref="T:System.Xml.Serialization.SoapReflectionImporter" /> instance's context for later use when import methods are invoked. </para>
</summary>
<param name="provider">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Reflection.ICustomAttributeProvider" /> reflection object that contains custom attributes that are derived from the <see cref="T:System.Xml.Serialization.SoapIncludeAttribute" /> attribute.</param>
</Docs>
</Member>
</Members>
</Type>

144
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaExporter.xml Normal file
View File

@@ -0,0 +1,144 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapSchemaExporter" FullName="System.Xml.Serialization.SoapSchemaExporter">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapSchemaExporter" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapSchemaExporter extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>SOAP encoding of SOAP Web service messages is described in Section 5 of the SOAP 1.1 specification.</para>
<para>The <see cref="T:System.Xml.Schema.XmlSchema" /> class provides a programmatic representation of an XML Schema definition language (XSD) document.</para>
<para>You should not use the <see cref="T:System.Xml.Serialization.SoapSchemaExporter" /> class directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Populates <see cref="T:System.Xml.Schema.XmlSchema" /> objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaExporter (System.Xml.Serialization.XmlSchemas schemas);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.XmlSchemas schemas) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="schemas" Type="System.Xml.Serialization.XmlSchemas" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not create an instance of the <see cref="T:System.Xml.Serialization.SoapSchemaExporter" /> class directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaExporter" /> class, which supplies the collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects to which XML Schema element declarations are to be added.</para>
</summary>
<param name="schemas">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects to which element declarations obtained from type mappings are to be added.</param>
</Docs>
</Member>
<Member MemberName="ExportMembersMapping">
<MemberSignature Language="C#" Value="public void ExportMembersMapping (System.Xml.Serialization.XmlMembersMapping xmlMembersMapping);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void ExportMembersMapping(class System.Xml.Serialization.XmlMembersMapping xmlMembersMapping) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="xmlMembersMapping" Type="System.Xml.Serialization.XmlMembersMapping" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not use the <see cref="T:System.Xml.Serialization.SoapSchemaExporter" /> class directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds to the applicable <see cref="T:System.Xml.Schema.XmlSchema" /> object a data type definition for each of the element parts of a SOAP-encoded message definition.</para>
</summary>
<param name="xmlMembersMapping">
<attribution license="cc4" from="Microsoft" modified="false" />Internal .NET Framework type mappings for the element parts of a WSDL message definition.</param>
</Docs>
</Member>
<Member MemberName="ExportMembersMapping">
<MemberSignature Language="C#" Value="public void ExportMembersMapping (System.Xml.Serialization.XmlMembersMapping xmlMembersMapping, bool exportEnclosingType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void ExportMembersMapping(class System.Xml.Serialization.XmlMembersMapping xmlMembersMapping, bool exportEnclosingType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="xmlMembersMapping" Type="System.Xml.Serialization.XmlMembersMapping" />
<Parameter Name="exportEnclosingType" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not use the <see cref="T:System.Xml.Serialization.SoapSchemaExporter" /> class directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds to the applicable <see cref="T:System.Xml.Schema.XmlSchema" /> object a data type definition for each of the element parts of a SOAP-encoded message definition.</para>
</summary>
<param name="xmlMembersMapping">
<attribution license="cc4" from="Microsoft" modified="false" />Internal .NET Framework type mappings for the element parts of a WSDL message definition.</param>
<param name="exportEnclosingType">
<attribution license="cc4" from="Microsoft" modified="false" />true to export a type definition for the parent element of the WSDL parts; otherwise, false.</param>
</Docs>
</Member>
<Member MemberName="ExportTypeMapping">
<MemberSignature Language="C#" Value="public void ExportTypeMapping (System.Xml.Serialization.XmlTypeMapping xmlTypeMapping);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void ExportTypeMapping(class System.Xml.Serialization.XmlTypeMapping xmlTypeMapping) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="xmlTypeMapping" Type="System.Xml.Serialization.XmlTypeMapping" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should not use the <see cref="T:System.Xml.Serialization.SoapSchemaExporter" /> class directly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds to the applicable <see cref="T:System.Xml.Schema.XmlSchema" /> object a data type definition for a .NET Framework type.</para>
</summary>
<param name="xmlTypeMapping">
<attribution license="cc4" from="Microsoft" modified="false" />An internal mapping between a .NET Framework type and an XML Schema element.</param>
</Docs>
</Member>
</Members>
</Type>

381
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaImporter.xml Normal file
View File

@@ -0,0 +1,381 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapSchemaImporter" FullName="System.Xml.Serialization.SoapSchemaImporter">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapSchemaImporter : System.Xml.Serialization.SchemaImporter" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapSchemaImporter extends System.Xml.Serialization.SchemaImporter" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Xml.Serialization.SchemaImporter</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the <format type="text/html"><a href="b9210348-8bc2-4367-8c91-d1a04b403e88">Web Services Description Language Tool (Wsdl.exe)</a></format>, and the <see cref="T:System.Web.Services.Description.ServiceDescriptionImporter" /> class, while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of using this class directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class has methods to generate internal mappings to .NET Framework types for part elements defined in a WSDL document. The class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaImporter (System.Xml.Serialization.XmlSchemas schemas);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.XmlSchemas schemas) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="schemas" Type="System.Xml.Serialization.XmlSchemas" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>SOAP encoding, as defined in Section 5 of the SOAP 1.1 specification, is specified in a WSDL document.</para>
<para>Instead of creating an instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class directly, use Wsdl.exe.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class, specifying <see cref="T:System.Xml.Schema.XmlSchema" /> objects representing the XML schemas used by SOAP encoded messages defined in a WSDL document. </para>
</summary>
<param name="schemas">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaImporter (System.Xml.Serialization.XmlSchemas schemas, System.Xml.Serialization.CodeIdentifiers typeIdentifiers);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.XmlSchemas schemas, class System.Xml.Serialization.CodeIdentifiers typeIdentifiers) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="schemas" Type="System.Xml.Serialization.XmlSchemas" />
<Parameter Name="typeIdentifiers" Type="System.Xml.Serialization.CodeIdentifiers" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>SOAP encoding, as defined in Section 5 of the SOAP 1.1 specification, is specified in a WSDL document.</para>
<para>Instead of creating an instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class directly, use Wsdl.exe.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class, specifying <see cref="T:System.Xml.Schema.XmlSchema" /> objects representing the XML schemas used by SOAP encoded messages, plus classes being generated for bindings defined in a WSDL document. </para>
</summary>
<param name="schemas">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects.</param>
<param name="typeIdentifiers">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> object that specifies a collection of classes being generated for bindings defined in a WSDL document.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaImporter (System.Xml.Serialization.XmlSchemas schemas, System.Xml.Serialization.CodeGenerationOptions options, System.Xml.Serialization.ImportContext context);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.XmlSchemas schemas, valuetype System.Xml.Serialization.CodeGenerationOptions options, class System.Xml.Serialization.ImportContext context) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="schemas" Type="System.Xml.Serialization.XmlSchemas" />
<Parameter Name="options" Type="System.Xml.Serialization.CodeGenerationOptions" />
<Parameter Name="context" Type="System.Xml.Serialization.ImportContext" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class specifying the schemas, compiler options, and the context of the schemas.</para>
</summary>
<param name="schemas">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects.</param>
<param name="options">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Xml.Serialization.CodeGenerationOptions" /> that specifies various options for generating a .NET Framework type.</param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Serialization.ImportContext" /> that describes the context in which a set of schema are bound to .NET Framework code entities. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaImporter (System.Xml.Serialization.XmlSchemas schemas, System.Xml.Serialization.CodeIdentifiers typeIdentifiers, System.Xml.Serialization.CodeGenerationOptions options);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.XmlSchemas schemas, class System.Xml.Serialization.CodeIdentifiers typeIdentifiers, valuetype System.Xml.Serialization.CodeGenerationOptions options) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="schemas" Type="System.Xml.Serialization.XmlSchemas" />
<Parameter Name="typeIdentifiers" Type="System.Xml.Serialization.CodeIdentifiers" />
<Parameter Name="options" Type="System.Xml.Serialization.CodeGenerationOptions" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class specifying the schemas, compiler options, and names of related code entities.</para>
</summary>
<param name="schemas">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects.</param>
<param name="typeIdentifiers">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> that maintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.</param>
<param name="options">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Xml.Serialization.CodeGenerationOptions" /> that specifies various options for generating a .NET Framework type.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaImporter (System.Xml.Serialization.XmlSchemas schemas, System.Xml.Serialization.CodeGenerationOptions options, System.CodeDom.Compiler.CodeDomProvider codeProvider, System.Xml.Serialization.ImportContext context);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Xml.Serialization.XmlSchemas schemas, valuetype System.Xml.Serialization.CodeGenerationOptions options, class System.CodeDom.Compiler.CodeDomProvider codeProvider, class System.Xml.Serialization.ImportContext context) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="schemas" Type="System.Xml.Serialization.XmlSchemas" />
<Parameter Name="options" Type="System.Xml.Serialization.CodeGenerationOptions" />
<Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
<Parameter Name="context" Type="System.Xml.Serialization.ImportContext" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class specifying the schemas, compiler options, and names of related code entities.</para>
</summary>
<param name="schemas">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Serialization.XmlSchemas" /> containing a collection of <see cref="T:System.Xml.Schema.XmlSchema" /> objects.</param>
<param name="options">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Xml.Serialization.CodeGenerationOptions" /> that specifies various options for generating a .NET Framework type.</param>
<param name="codeProvider">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> used to generate the serialization code.</param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Serialization.ImportContext" /> that describes the context in which a set of schema are bound to .NET Framework code entities.</param>
</Docs>
</Member>
<Member MemberName="ImportDerivedTypeMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlTypeMapping ImportDerivedTypeMapping (System.Xml.XmlQualifiedName name, Type baseType, bool baseTypeCanBeIndirect);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlTypeMapping ImportDerivedTypeMapping(class System.Xml.XmlQualifiedName name, class System.Type baseType, bool baseTypeCanBeIndirect) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlTypeMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
<Parameter Name="baseType" Type="System.Type" />
<Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportDerivedTypeMapping(System.Xml.XmlQualifiedName,System.Type,System.Boolean)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the <format type="text/html"><a href="b9210348-8bc2-4367-8c91-d1a04b403e88">Web Services Description Language Tool (Wsdl.exe)</a></format> while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mapping information for the type of a SOAP-encoded element part defined in a WSDL document where a base type is specified. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The .NET Framework type mapping information for a derived type corresponding to a WSDL message part.</para>
</returns>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of an element's type for which a .NET Framework type is being generated.</param>
<param name="baseType">
<attribution license="cc4" from="Microsoft" modified="false" />A base type for the .NET Framework type being generated.</param>
<param name="baseTypeCanBeIndirect">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that the type being generated may indirectly inherit from the base type; otherwise, false.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string name, string ns, System.Xml.Serialization.SoapSchemaMember member);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string name, string ns, class System.Xml.Serialization.SoapSchemaMember member) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="member" Type="System.Xml.Serialization.SoapSchemaMember" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification. This signature of the <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember)" /> method is used when a WSDL message is wrapped within a single part element.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mapping information for a single SOAP-encoded element part defined in a WSDL document. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The .NET Framework type mapping for a single element part of a WSDL message definition.</para>
</returns>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The message namespace.</param>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> object that provides information about the part element.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string name, string ns, System.Xml.Serialization.SoapSchemaMember[] members);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string name, string ns, class System.Xml.Serialization.SoapSchemaMember[] members) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.SoapSchemaMember[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[])" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification. The parameter values to the <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[])" /> method are taken from a message definition in a WSDL document, including the part elements the message element contains.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mapping information for the element parts of a SOAP-encoded message defined in a WSDL document. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
</returns>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The message namespace.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> that provides information about the part elements.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string name, string ns, System.Xml.Serialization.SoapSchemaMember[] members, bool hasWrapperElement);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string name, string ns, class System.Xml.Serialization.SoapSchemaMember[] members, bool hasWrapperElement) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.SoapSchemaMember[]" />
<Parameter Name="hasWrapperElement" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[],System.Boolean)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification. The parameter values to the <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[],System.Boolean)" /> method are taken from a message definition in a WSDL document, including the part elements the message element contains.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mapping information for the element parts of a SOAP-encoded message defined in a WSDL document. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
</returns>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The message namespace.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> that provides information about the part elements.</param>
<param name="hasWrapperElement">
<attribution license="cc4" from="Microsoft" modified="false" />true to have elements defined by the parts enclosed in an extra, wrapper element in a SOAP message; otherwise, false.</param>
</Docs>
</Member>
<Member MemberName="ImportMembersMapping">
<MemberSignature Language="C#" Value="public System.Xml.Serialization.XmlMembersMapping ImportMembersMapping (string name, string ns, System.Xml.Serialization.SoapSchemaMember[] members, bool hasWrapperElement, Type baseType, bool baseTypeCanBeIndirect);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Xml.Serialization.XmlMembersMapping ImportMembersMapping(string name, string ns, class System.Xml.Serialization.SoapSchemaMember[] members, bool hasWrapperElement, class System.Type baseType, bool baseTypeCanBeIndirect) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.Serialization.XmlMembersMapping</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.String" />
<Parameter Name="ns" Type="System.String" />
<Parameter Name="members" Type="System.Xml.Serialization.SoapSchemaMember[]" />
<Parameter Name="hasWrapperElement" Type="System.Boolean" />
<Parameter Name="baseType" Type="System.Type" />
<Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[],System.Boolean,System.Type,System.Boolean)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification. The parameter values to the <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[],System.Boolean,System.Type,System.Boolean)" /> method are taken from a message definition in a WSDL document, including the part elements the message element contains.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates internal type mapping information for the element parts of a SOAP-encoded message defined in a WSDL document.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
</returns>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
<param name="ns">
<attribution license="cc4" from="Microsoft" modified="false" />The message namespace.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> that provides information about the part elements.</param>
<param name="hasWrapperElement">
<attribution license="cc4" from="Microsoft" modified="false" />true to have elements defined by the parts enclosed in an extra, wrapper element in a SOAP message; otherwise, false.</param>
<param name="baseType">
<attribution license="cc4" from="Microsoft" modified="false" />A base type for all .NET Framework types that are generated to correspond to message parts.</param>
<param name="baseTypeCanBeIndirect">
<attribution license="cc4" from="Microsoft" modified="false" />true to indicate that types corresponding to message parts can indirectly inherit from the base type; otherwise, false.</param>
</Docs>
</Member>
</Members>
</Type>

101
mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaMember.xml Normal file
View File

@@ -0,0 +1,101 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SoapSchemaMember" FullName="System.Xml.Serialization.SoapSchemaMember">
<TypeSignature Maintainer="auto" Language="C#" Value="public class SoapSchemaMember" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SoapSchemaMember extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Xml</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>To be added</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of using this class directly, use Wsdl.exe.</para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> class has properties that correspond to the name and type attributes of a WSDL part element. The class is used only when a WSDL document specifies SOAP encoding, as described in Section 5 of the SOAP 1.1 specification.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents certain attributes of a XSD &lt;part&gt; element in a WSDL document for generating classes from the document. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SoapSchemaMember ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="MemberName">
<MemberSignature Language="C#" Value="public string MemberName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string MemberName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property corresponds to the XML name attribute of the XML element &lt;wsdl:part&gt;. For more information about the element, see <see cref="http://www.w3.org/TR/wsdl">http://www.w3.org/TR/wsdl</see>. </para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> class is used by the Wsdl.exe tool while generating classes from a Web Services Description Language (WSDL) document that specifies SOAP encoding. Instead of using this class directly, use Wsdl.exe.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that corresponds to the name attribute of the WSDL part element. </para>
</summary>
</Docs>
</Member>
<Member MemberName="MemberType">
<MemberSignature Language="C#" Value="public System.Xml.XmlQualifiedName MemberType { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.XmlQualifiedName MemberType" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.XmlQualifiedName</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>To be added: an object of type 'System.Xml.XmlQualifiedName'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property corresponds to the XML type attribute of the XML element &lt;wsdl:part&gt;. For more information about the element, see <see cref="http://www.w3.org/TR/wsdl">http://www.w3.org/TR/wsdl</see>. </para>
<para>The <see cref="T:System.Xml.Serialization.SoapSchemaMember" /> class is used by the Wsdl.exe tool while generating classes from a Web Services Description Language (WSDL) document that specifies SOAP encoding. Instead of using this class directly, use Wsdl.exe.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that corresponds to the type attribute of the WSDL part element.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

Some files were not shown because too many files have changed in this diff Show More