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

165
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/CollectionDataContractAttribute.xml Normal file
View File

@@ -0,0 +1,165 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CollectionDataContractAttribute" FullName="System.Runtime.Serialization.CollectionDataContractAttribute">
<TypeSignature Language="C#" Value="public sealed class CollectionDataContractAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit CollectionDataContractAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.All, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Serialization.CollectionDataContractAttribute" /> is intended to ease interoperability when working with data from non-indigo2 providers and to control the exact shape of serialized instances. To this end, the <see cref="P:System.Runtime.Serialization.CollectionDataContractAttribute.ItemName" /> property enables you to control the names of the repeating items inside a collection. This is especially useful when the provider does not use the XML element type name as the array item name, for example, if a provider uses "String" as an element type name instead of the XSD type name "string". </para>
<para>The <see cref="T:System.Runtime.Serialization.CollectionDataContractAttribute" /> is also intended to be used with dictionary types to handle keyed collections. Dictionary types are classes that implement either the <see cref="T:System.Collections.IDictionary" /> or the <see cref="T:System.Collections.Generic.IDictionary`2" /> interface, for example, the <see cref="T:System.Collections.Generic.Dictionary`2" />. Use the <see cref="P:System.Runtime.Serialization.CollectionDataContractAttribute.KeyName" /> and <see cref="P:System.Runtime.Serialization.CollectionDataContractAttribute.ValueName" /> properties to set custom names when using the <see cref="T:System.Collections.Generic.Dictionary`2" /> class.</para>
<para>crabout using the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />, see <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Data Contracts Overview</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When applied to a collection type, enables custom specification of the collection item elements. This attribute can be applied only to types that are recognized by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> as valid, serializable collections. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CollectionDataContractAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.CollectionDataContractAttribute" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="IsReference">
<MemberSignature Language="C#" Value="public bool IsReference { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsReference" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The IsReference setting does not apply to the elements of the collection.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that indicates whether to preserve object reference data.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ItemName">
<MemberSignature Language="C#" Value="public string ItemName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ItemName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a custom name for a collection element.</para>
</summary>
</Docs>
</Member>
<Member MemberName="KeyName">
<MemberSignature Language="C#" Value="public string KeyName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string KeyName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the custom name for a dictionary key name.</para>
</summary>
</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>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the data contract name for the collection type.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Namespace">
<MemberSignature Language="C#" Value="public string Namespace { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Namespace" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the namespace for the data contract.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ValueName">
<MemberSignature Language="C#" Value="public string ValueName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ValueName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the custom name for a dictionary value name.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

94
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/ContractNamespaceAttribute.xml Normal file
View File

@@ -0,0 +1,94 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ContractNamespaceAttribute" FullName="System.Runtime.Serialization.ContractNamespaceAttribute">
<TypeSignature Language="C#" Value="public sealed class ContractNamespaceAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit ContractNamespaceAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Module | System.AttributeTargets.All, AllowMultiple=true, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply the <see cref="T:System.Runtime.Serialization.ContractNamespaceAttribute" /> attribute to an assembly that contains types to which the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> has been applied. The <see cref="T:System.Runtime.Serialization.ContractNamespaceAttribute" /> enables you to set a namespace that is different than the one generated when the type is serialized. For more information about how names are generated, see <format type="text/html"><a href="31f87e6c-247b-48f5-8e94-b9e1e33d8d09">Data Contract Names</a></format>.</para>
<para>If you are using a type to conform to an existing data contract, you must match the namespace of the existing contract by using the <see cref="T:System.Runtime.Serialization.ContractNamespaceAttribute" /> (or the <see cref="P:System.Runtime.Serialization.DataContractAttribute.Namespace" /> property of the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> class).</para>
<block subset="none" type="note">
<para>In any code, you can use the word ContractNamespace instead of the longer <see cref="T:System.Runtime.Serialization.ContractNamespaceAttribute" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the CLR namespace and XML namespace of the data contract. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ContractNamespaceAttribute (string ns);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string ns) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="ns" Type="System.String" />
</Parameters>
<Docs>
<param name="ns">To be added.</param>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.ContractNamespaceAttribute" /> class using the supplied namespace. </para>
</summary>
</Docs>
</Member>
<Member MemberName="ClrNamespace">
<MemberSignature Language="C#" Value="public string ClrNamespace { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ClrNamespace" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the CLR namespace of the data contract type. </para>
</summary>
</Docs>
</Member>
<Member MemberName="ContractNamespace">
<MemberSignature Language="C#" Value="public string ContractNamespace { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ContractNamespace" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property can only be set using the constructor when applying the attribute to an assembly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the namespace of the data contract members.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

147
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractAttribute.xml Normal file
View File

@@ -0,0 +1,147 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DataContractAttribute" FullName="System.Runtime.Serialization.DataContractAttribute">
<TypeSignature Language="C#" Value="public sealed class DataContractAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit DataContractAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Enum | System.AttributeTargets.All, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute to types (classes, structures, or enumerations) that are used in serialization and deserialization operations by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. If you send or receive messages by using the indigo1 infrastructure, you should also apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> to any classes that hold and manipulate data sent in messages. crabout data contracts, see <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Using Data Contracts</a></format>.</para>
<para>You must also apply the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> to any field, property, or event that holds values you want to serialize. By applying the <see cref="T:System.Runtime.Serialization.DataContractAttribute" />, you explicitly enable the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> to serialize and deserialize the data. </para>
<block subset="none" type="note">
<para>You can apply the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> to private fields. Be aware that the data returned by the field (even if it is private) is serialized and deserialized, and thus can be viewed or intercepted by a malicious user or process.</para>
</block>
<para>crabout data contracts, see the topics listed in <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Using Data Contracts</a></format>.</para>
<format type="text/html">
<h2>Data Contracts</h2>
</format>
<para>A <newTerm>data contract</newTerm> is an abstract description of a set of fields with a name and data type for each field. The data contract exists outside of any single implementation to allow services on different platforms to interoperate. As long as the data passed between the services conforms to the same contract, all the services can process the data. This processing is also known as a <newTerm>loosely coupled system</newTerm>. A data contract is also similar to an interface in that the contract specifies how data must be delivered so that it can be processed by an application. For example, the data contract may call for a data type named "Person" that has two text fields, named "FirstName" and "LastName". To create a data contract, apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> to the class and apply the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> to any fields or properties that must be serialized. When serialized, the data conforms to the data contract that is implicitly built into the type. </para>
<block subset="none" type="note">
<para>A data contract differs significantly from an actual interface in its inheritance behavior. Interfaces are inherited by any derived types. When you apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> to a base class, the derived types do not inherit the attribute or the behavior. However, if a derived type has a data contract, the data members of the base class are serialized. However, you must apply the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> to new members in a derived class to make them serializable. </para>
</block>
<format type="text/html">
<h2>XML Schema Documents and the SvcUtil Tool</h2>
</format>
<para>If you are exchanging data with other services, you must describe the data contract. For the current version of the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />, an XML schema can be used to define data contracts. (Other forms of metadata/description could be used for the same purpose.) To create an XML schema from your application, use the <format type="text/html"><a href="1abf3d9f-b420-46f1-b628-df238751f308">Service Model Metadata Utility Tool (Svcutil.exe)</a></format> with the <system>/dconly</system> command line option. When the input to the tool is an assembly, by default, the tool generates a set of XML schemas that define all the data contract types found in that assembly. Conversely, you can also use the Svcutil.exe tool to create Visual Basic or C# class definitions that conform to the requirements of XML schemas that use constructs that can be expressed by data contracts. In this case, the <system>/dconly</system> command line option is not required.</para>
<para>If the input to the Svcutil.exe tool is an XML schema, by default, the tool creates a set of classes. If you examine those classes, you find that the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> has been applied. You can use those classes to create a new application to process data that must be exchanged with other services. </para>
<para>You can also run the tool against an endpoint that returns a Web Services Description Language (WSDL) document to automatically generate the code and configuration to create an indigo1 client. The generated code includes types that are marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" />.</para>
<format type="text/html">
<h2>Reusing Existing Types</h2>
</format>
<para>A data contract has two basic requirements: a stable name and a list of members. The stable name consists of the namespace uniform resource identifier (URI) and the local name of the contract. By default, when you apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> to a class, it uses the class name as the local name and the class's namespace (prefixed with "http://schemas.datacontract.org/2004/07/") as the namespace URI. You can override the defaults by setting the <see cref="P:System.Runtime.Serialization.DataContractAttribute.Name" /> and <see cref="P:System.Runtime.Serialization.DataContractAttribute.Namespace" /> properties. You can also change the namespace by applying the <see cref="T:System.Runtime.Serialization.ContractNamespaceAttribute" /> to the namespace. Use this capability when you have an existing type that processes data exactly as you require but has a different namespace and class name from the data contract. By overriding the default values, you can reuse your existing type and have the serialized data conform to the data contract. </para>
<block subset="none" type="note">
<para>In any code, you can use the word DataContract instead of the longer <see cref="T:System.Runtime.Serialization.DataContractAttribute" />.</para>
</block>
<format type="text/html">
<h2>Versioning</h2>
</format>
<para>A data contract can also accommodate later versions of itself. That is, when a later version of the contract includes extra data, that data is stored and returned to a sender untouched. To do this, implement the <see cref="T:System.Runtime.Serialization.IExtensibleDataObject" /> interface. </para>
<para>crabout versioning, see <format type="text/html"><a href="4a0700cb-5f5f-4137-8705-3a3ecf06461f">Data Contract Versioning</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. To make their type serializable, type authors must define a data contract for their type. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DataContractAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.DataContractAttribute" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="IsReference">
<MemberSignature Language="C#" Value="public bool IsReference { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsReference" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the IsReference property to instruct the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> to insert XML constructs that preserve object reference information.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that indicates whether to preserve object reference data.</para>
</summary>
</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>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Runtime.Serialization.DataContractAttribute.Name" /> property is used to give a name to a data contract, which is the name of the type in XML schema. crdefault <format type="text/html"><a href="31f87e6c-247b-48f5-8e94-b9e1e33d8d09">Data Contract Names</a></format>. </para>
<para>By default, the name of a data contract is the name of the type that the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> is applied to. However, there may be reasons to change this default name. One reason is to allow an existing type to process data that must conform to an existing data contract. For example, there exists a type named Person but the data contract, embodied in an XML schema, requires that the name be Customer. The contract can be satisfied by setting the property value to Customer.</para>
<para>A second reason is to allow the generation of names that are invalid as type names. For example, if a data contract demands a name that is not allowable as a type name, set the property value to that disallowed name. For instance, the string "$value" is disallowed as a type name but is allowed as a <see cref="P:System.Runtime.Serialization.DataContractAttribute.Name" /> property value. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the name of the data contract for the type.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Namespace">
<MemberSignature Language="C#" Value="public string Namespace { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Namespace" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use this property to specify a particular namespace if your type must return data that complies with a specific data contract. </para>
<block subset="none" type="note">
<para>For the data to be successfully transmitted, the name of the data in a data contract must be the same in both the client and the server. Visual Basic projects, by default, add a prefix to the namespace defined in each file (called the “root namespace,” named after the project). Adding this prefix causes the client and server namespaces to be different for the same type. The solution is to set the <see cref="P:System.Runtime.Serialization.DataContractAttribute.Namespace" /> property to “”, or to explicitly set the data contract namespace in this property.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the namespace for the data contract for the type.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

111
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractResolver.xml Normal file
View File

@@ -0,0 +1,111 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DataContractResolver" FullName="System.Runtime.Serialization.DataContractResolver">
<TypeSignature Language="C#" Value="public abstract class DataContractResolver" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit DataContractResolver extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Developers should be careful about what data is being sent over the wire. You can use transport or message security to secure that data. crdefault see <format type="text/html"><a href="05d73638-30a9-43b4-8c86-f27f57b6eef1">Security</a></format>.</para>
<block subset="none" type="note">
<para>Only use <see cref="T:System.Runtime.Serialization.DataContractResolver" /> if you are completely sure of what information is being serialized. Malicious types can cause unexpected behavior.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected DataContractResolver ();" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.DataContractResolver" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="ResolveName">
<MemberSignature Language="C#" Value="public abstract Type ResolveName (string typeName, string typeNamespace, Type declaredType, System.Runtime.Serialization.DataContractResolver knownTypeResolver);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Type ResolveName(string typeName, string typeNamespace, class System.Type declaredType, class System.Runtime.Serialization.DataContractResolver knownTypeResolver) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="typeName" Type="System.String" />
<Parameter Name="typeNamespace" Type="System.String" />
<Parameter Name="declaredType" Type="System.Type" />
<Parameter Name="knownTypeResolver" Type="System.Runtime.Serialization.DataContractResolver" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you want to use the known type resolution logic inside your implementation, a reference to it is passed in as the <paramref name="knownTypeResolver" /> parameter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Override this method to map the specified xsi:type name and namespace to a data contract type during deserialization.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The type the xsi:type name and namespace is mapped to. </para>
</returns>
<param name="typeName">
<attribution license="cc4" from="Microsoft" modified="false" />The xsi:type name to map.</param>
<param name="typeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />The xsi:type namespace to map.</param>
<param name="declaredType">
<attribution license="cc4" from="Microsoft" modified="false" />The type declared in the data contract.</param>
<param name="knownTypeResolver">
<attribution license="cc4" from="Microsoft" modified="false" />The known type resolver.</param>
</Docs>
</Member>
<Member MemberName="TryResolveType">
<MemberSignature Language="C#" Value="public abstract bool TryResolveType (Type type, Type declaredType, System.Runtime.Serialization.DataContractResolver knownTypeResolver, out System.Xml.XmlDictionaryString typeName, out System.Xml.XmlDictionaryString typeNamespace);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance bool TryResolveType(class System.Type type, class System.Type declaredType, class System.Runtime.Serialization.DataContractResolver knownTypeResolver, class System.Xml.XmlDictionaryString typeName, class System.Xml.XmlDictionaryString typeNamespace) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="declaredType" Type="System.Type" />
<Parameter Name="knownTypeResolver" Type="System.Runtime.Serialization.DataContractResolver" />
<Parameter Name="typeName" Type="System.Xml.XmlDictionaryString&amp;" RefType="out" />
<Parameter Name="typeNamespace" Type="System.Xml.XmlDictionaryString&amp;" RefType="out" />
</Parameters>
<Docs>
<param name="type">To be added.</param>
<param name="declaredType">To be added.</param>
<param name="knownTypeResolver">To be added.</param>
<param name="typeName">To be added.</param>
<param name="typeNamespace">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
</Type>

1014
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractSerializer.xml Normal file
View File

File diff suppressed because it is too large Load Diff

209
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractSerializerSettings.xml Normal file
View File

@@ -0,0 +1,209 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DataContractSerializerSettings" FullName="System.Runtime.Serialization.DataContractSerializerSettings">
<TypeSignature Language="C#" Value="public class DataContractSerializerSettings" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DataContractSerializerSettings extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies data contract serializer settings.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DataContractSerializerSettings ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.DataContractSerializerSettings" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="DataContractResolver">
<MemberSignature Language="C#" Value="public System.Runtime.Serialization.DataContractResolver DataContractResolver { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Runtime.Serialization.DataContractResolver DataContractResolver" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.DataContractResolver</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the component used to dynamically map xsi:type declarations to known contract types.</para>
</summary>
</Docs>
</Member>
<Member MemberName="DataContractSurrogate">
<MemberSignature Language="C#" Value="public System.Runtime.Serialization.IDataContractSurrogate DataContractSurrogate { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Runtime.Serialization.IDataContractSurrogate DataContractSurrogate" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.IDataContractSurrogate</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a serialization surrogate.</para>
</summary>
</Docs>
</Member>
<Member MemberName="IgnoreExtensionDataObject">
<MemberSignature Language="C#" Value="public bool IgnoreExtensionDataObject { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IgnoreExtensionDataObject" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether to ignore data supplied by an extension of the class when the class is being serialized or deserialized.</para>
</summary>
</Docs>
</Member>
<Member MemberName="KnownTypes">
<MemberSignature Language="C#" Value="public System.Collections.Generic.IEnumerable&lt;Type&gt; KnownTypes { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Generic.IEnumerable`1&lt;class System.Type&gt; KnownTypes" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Generic.IEnumerable&lt;System.Type&gt;</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a collection of types that may be present in the object graph serialized using this instance of the DataContractSerializerSettings.</para>
</summary>
</Docs>
</Member>
<Member MemberName="MaxItemsInObjectGraph">
<MemberSignature Language="C#" Value="public int MaxItemsInObjectGraph { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 MaxItemsInObjectGraph" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the maximum number of items in an object graph to serialize or deserialize.</para>
</summary>
</Docs>
</Member>
<Member MemberName="PreserveObjectReferences">
<MemberSignature Language="C#" Value="public bool PreserveObjectReferences { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool PreserveObjectReferences" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether to use non-standard XML constructs to preserve object reference data.</para>
</summary>
</Docs>
</Member>
<Member MemberName="RootName">
<MemberSignature Language="C#" Value="public System.Xml.XmlDictionaryString RootName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.XmlDictionaryString RootName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.XmlDictionaryString</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the root name of the selected object.</para>
</summary>
</Docs>
</Member>
<Member MemberName="RootNamespace">
<MemberSignature Language="C#" Value="public System.Xml.XmlDictionaryString RootNamespace { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Xml.XmlDictionaryString RootNamespace" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Xml.XmlDictionaryString</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the root namespace for the specified object.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SerializeReadOnlyTypes">
<MemberSignature Language="C#" Value="public bool SerializeReadOnlyTypes { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool SerializeReadOnlyTypes" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether to serialize read only types.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

147
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataMemberAttribute.xml Normal file
View File

@@ -0,0 +1,147 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DataMemberAttribute" FullName="System.Runtime.Serialization.DataMemberAttribute">
<TypeSignature Language="C#" Value="public sealed class DataMemberAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit DataMemberAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Property | System.AttributeTargets.Field | System.AttributeTargets.All, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> attribute in conjunction with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> to identify members of a type that are part of a data contract. One of the serializers that can serialize data contracts is the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. </para>
<para>The data contract model is an "opt-in" model. Applying the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> to a field or property explicitly specifies that the member value will be serialized. In contrast, the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter" /> serializes public and private fields of a type, and the <see cref="T:System.Xml.Serialization.XmlSerializer" /> serializes only public fields and properties of a type. </para>
<block subset="none" type="note">
<para>You can apply the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> to private fields or properties. Be aware that the data returned by the member (even if it private) will be serialized and deserialized, and thus can be viewed or intercepted by a malicious user or process. </para>
</block>
<para>By default, the CLR member name is used as the name of the data member. By setting the <see cref="P:System.Runtime.Serialization.DataMemberAttribute.Name" /> property, you can customize the name of the data member. This can be used to provide a name that may not be allowed as a CLR member name. When mapping to XML using the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />, this name is used as the name of the schema element in a type.</para>
<block subset="none" type="note">
<para>Properties to which the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> attribute has been applied must have both get and set fields; they cannot be get-only or set-only.</para>
</block>
<para>For more information about data contracts and data members, see <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Using Data Contracts</a></format>. For more information about member names, see <format type="text/html"><a href="53a3b505-4b27-444b-b079-0eb84a97cfd8">Data Member Default Values</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When applied to the member of a type, specifies that the member is part of a data contract and is serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DataMemberAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.DataMemberAttribute" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="EmitDefaultValue">
<MemberSignature Language="C#" Value="public bool EmitDefaultValue { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool EmitDefaultValue" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>In the dnprdnshort, types have a concept of default values. For example, for any reference type the default value is null, and for an integer type it is 0. It is occasionally desirable to omit a data member from the serialized data when it is set to its default value. To do this, set the <see cref="P:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue" /> property to false (it is true by default). </para>
<block subset="none" type="note">
<para>Setting the <see cref="P:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue" /> property to false is not a recommended practice. It should only be done if there is a specific need to do so (such as for interoperability or to reduce data size).</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether to serialize the default value for a field or property being serialized. </para>
</summary>
</Docs>
</Member>
<Member MemberName="IsRequired">
<MemberSignature Language="C#" Value="public bool IsRequired { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsRequired" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The property is used for ensuring compatibility with future versions of a type. For more information, see <format type="text/html"><a href="4a0700cb-5f5f-4137-8705-3a3ecf06461f">Data Contract Versioning</a></format> and <format type="text/html"><a href="bf0ab338-4d36-4e12-8002-8ebfdeb346cb">Best Practices: Data Contract Versioning</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that instructs the serialization engine that the member must be present when reading or deserializing.</para>
</summary>
</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>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property is used to override the default name of the data member that is derived from the name of the member annotated with the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" />. </para>
<para>The <see cref="P:System.Runtime.Serialization.DataMemberAttribute.Name" /> property enables you to use names that are not permitted as common language runtime (CLR) identifiers. In addition, this property enables the type author to define a data member name separate from the CLR member name. This separate definition helps in versioning scenarios (changing the CLR member name without breaking the data contract) and allows a different naming convention for data contact members and CLR members. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a data member name. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Order">
<MemberSignature Language="C#" Value="public int Order { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 Order" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If a type requires that one member be serialized or deserialized before another, use this property to specify the order. For more information, see <format type="text/html"><a href="0658a47d-b6e5-4ae0-ba72-ababc3c6ff33">Data Member Order</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the order of serialization and deserialization of a member.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

122
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DateTimeFormat.xml Normal file
View File

@@ -0,0 +1,122 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DateTimeFormat" FullName="System.Runtime.Serialization.DateTimeFormat">
<TypeSignature Language="C#" Value="public class DateTimeFormat" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DateTimeFormat extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies date-time format options.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DateTimeFormat (string formatString);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string formatString) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="formatString" 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.Runtime.Serialization.DateTimeFormat" /> class using the format string.</para>
</summary>
<param name="formatString">
<attribution license="cc4" from="Microsoft" modified="false" />The format string.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DateTimeFormat (string formatString, IFormatProvider formatProvider);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string formatString, class System.IFormatProvider formatProvider) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="formatString" Type="System.String" />
<Parameter Name="formatProvider" Type="System.IFormatProvider" />
</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.Runtime.Serialization.DateTimeFormat" /> class using the format string and format provider.</para>
</summary>
<param name="formatString">
<attribution license="cc4" from="Microsoft" modified="false" />The format sting.</param>
<param name="formatProvider">
<attribution license="cc4" from="Microsoft" modified="false" />The format provider.</param>
</Docs>
</Member>
<Member MemberName="DateTimeStyles">
<MemberSignature Language="C#" Value="public System.Globalization.DateTimeStyles DateTimeStyles { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Globalization.DateTimeStyles DateTimeStyles" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Globalization.DateTimeStyles</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the formatting options that customize string parsing for some date and time parsing methods.</para>
</summary>
</Docs>
</Member>
<Member MemberName="FormatProvider">
<MemberSignature Language="C#" Value="public IFormatProvider FormatProvider { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.IFormatProvider FormatProvider" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.IFormatProvider</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets an object that controls formatting.</para>
</summary>
</Docs>
</Member>
<Member MemberName="FormatString">
<MemberSignature Language="C#" Value="public string FormatString { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string FormatString" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the format strings to control the formatting produced when a date or time is represented as a string.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

72
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/EmitTypeInformation.xml Normal file
View File

@@ -0,0 +1,72 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EmitTypeInformation" FullName="System.Runtime.Serialization.EmitTypeInformation">
<TypeSignature Language="C#" Value="public enum EmitTypeInformation" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed EmitTypeInformation extends System.Enum" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies how often to emit type information.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Always">
<MemberSignature Language="C#" Value="Always" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Runtime.Serialization.EmitTypeInformation Always = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.EmitTypeInformation</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Always to emit type information.</para>
</summary>
</Docs>
</Member>
<Member MemberName="AsNeeded">
<MemberSignature Language="C#" Value="AsNeeded" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Runtime.Serialization.EmitTypeInformation AsNeeded = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.EmitTypeInformation</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>As needed emit type information.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Never">
<MemberSignature Language="C#" Value="Never" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Runtime.Serialization.EmitTypeInformation Never = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.EmitTypeInformation</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Never to emit type information.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

69
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/EnumMemberAttribute.xml Normal file
View File

@@ -0,0 +1,69 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EnumMemberAttribute" FullName="System.Runtime.Serialization.EnumMemberAttribute">
<TypeSignature Language="C#" Value="public sealed class EnumMemberAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit EnumMemberAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Field, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Serialization.EnumMemberAttribute" /> enables fine control of the names of the enumerations as they are serialized. </para>
<para>To use <see cref="T:System.Runtime.Serialization.EnumMemberAttribute" />, create an enumeration and apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute to the enumeration. Then apply the <see cref="T:System.Runtime.Serialization.EnumMemberAttribute" /> attribute to each member that needs to be in the serialization stream.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that the field is an enumeration member and should be serialized.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public EnumMemberAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.EnumMemberAttribute" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Value">
<MemberSignature Language="C#" Value="public string Value { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Value" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, the value of an enumeration is the name of the enumeration. When a value is specified, that value will appear in the XML document or stream.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the value associated with the enumeration member the attribute is applied to. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

86
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/ExportOptions.xml Normal file
View File

@@ -0,0 +1,86 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ExportOptions" FullName="System.Runtime.Serialization.ExportOptions">
<TypeSignature Language="C#" Value="public class ExportOptions" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ExportOptions extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Serialization.XsdDataContractExporter" /> is used to generate XSD schemas from a type or assembly. You can also use the <see cref="T:System.Runtime.Serialization.XsdDataContractImporter" /> to generate dnprdnshort code from a schema document. </para>
<para>crabout importing and exporting schemas, see <format type="text/html"><a href="0da32b50-ccd9-463a-844c-7fe803d3bf44">Schema Import and Export</a></format> and <format type="text/html"><a href="bb57b962-70c1-45a9-93d5-e721e340a13f">Exporting Schemas From Classes</a></format>. </para>
<para>The <see cref="P:System.Runtime.Serialization.ExportOptions.KnownTypes" /> property is used by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> to include types that can be read in an object graph. crabout the data contract and known types, see <format type="text/html"><a href="1a0baea1-27b7-470d-9136-5bbad86c4337">Data Contract Known Types</a></format>.</para>
<para>crabout data contracts, see <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Using Data Contracts</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the options that can be set for an <see cref="T:System.Runtime.Serialization.XsdDataContractExporter" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ExportOptions ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.ExportOptions" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="DataContractSurrogate">
<MemberSignature Language="C#" Value="public System.Runtime.Serialization.IDataContractSurrogate DataContractSurrogate { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Runtime.Serialization.IDataContractSurrogate DataContractSurrogate" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.IDataContractSurrogate</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a serialization surrogate. </para>
</summary>
</Docs>
</Member>
<Member MemberName="KnownTypes">
<MemberSignature Language="C#" Value="public System.Collections.ObjectModel.Collection&lt;Type&gt; KnownTypes { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.ObjectModel.Collection`1&lt;class System.Type&gt; KnownTypes" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.ObjectModel.Collection&lt;System.Type&gt;</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Runtime.Serialization.ExportOptions.KnownTypes" /> property is used by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> to include types that can be read in an object graph (set using the <see cref="P:System.Runtime.Serialization.DataContractSerializer.KnownTypes" /> property). </para>
<para>crabout the data contract and known types, see <format type="text/html"><a href="1a0baea1-27b7-470d-9136-5bbad86c4337">Data Contract Known Types</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the collection of types that may be encountered during serialization or deserialization. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

24
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/ExtensionDataObject.xml Normal file
View File

@@ -0,0 +1,24 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ExtensionDataObject" FullName="System.Runtime.Serialization.ExtensionDataObject">
<TypeSignature Language="C#" Value="public sealed class ExtensionDataObject" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit ExtensionDataObject extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Serialization.ExtensionDataObject" /> is the structure that stores extra data encountered by the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> during deserialization operations. The structure is used by serialization to write the extra data into the serialized instance. The structure is returned by the <see cref="P:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData" /> property of the <see cref="T:System.Runtime.Serialization.IExtensibleDataObject" /> interface. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Stores data from a versioned data contract that has been extended by adding new members.</para>
</summary>
</Docs>
<Members />
</Type>

272
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IDataContractSurrogate.xml Normal file
View File

@@ -0,0 +1,272 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IDataContractSurrogate" FullName="System.Runtime.Serialization.IDataContractSurrogate">
<TypeSignature Language="C#" Value="public interface IDataContractSurrogate" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IDataContractSurrogate" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="T:System.Runtime.Serialization.IDataContractSurrogate" /> when using the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> if you need to do one of the following: substitute one type or object for another, or to dynamically generate schema variations. For a sample application, see <format type="text/html"><a href="b0188f3c-00a9-4cf0-a887-a2284c8fb014">DataContract Surrogate Sample</a></format>. For more information about data contracts, see <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Using Data Contracts</a></format>.</para>
<para>At run time, you can find the specific <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> for any operation in a service by using the <see cref="T:System.ServiceModel.Description.OperationDescription" /> to find the <see cref="T:System.ServiceModel.Description.DataContractSerializerOperationBehavior" /> instance. For more information about implementing the interface to create a surrogate, see <format type="text/html"><a href="8c31134c-46c5-4ed7-94af-bab0ac0dfce5">Data Contract Surrogates</a></format>.</para>
<para>You can also use the <see cref="T:System.Runtime.Serialization.IDataContractSurrogate" /> to affect the import and export of XML schemas when you are using the <see cref="T:System.Runtime.Serialization.XsdDataContractExporter" /> and <see cref="T:System.Runtime.Serialization.XsdDataContractImporter" /> classes. You can do so by assigning the <see cref="T:System.Runtime.Serialization.IDataContractSurrogate" /> to the <see cref="P:System.Runtime.Serialization.ExportOptions.DataContractSurrogate" /> property of the <see cref="T:System.Runtime.Serialization.ExportOptions" /> class, or to the <see cref="P:System.Runtime.Serialization.ImportOptions.DataContractSurrogate" /> property of the <see cref="T:System.Runtime.Serialization.ImportOptions" /> class. For more information, see <format type="text/html"><a href="0da32b50-ccd9-463a-844c-7fe803d3bf44">Schema Import and Export</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the methods needed to substitute one type for another by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> during serialization, deserialization, and export and import of XML schema documents (XSD). </para>
</summary>
</Docs>
<Members>
<Member MemberName="GetCustomDataToExport">
<MemberSignature Language="C#" Value="public object GetCustomDataToExport (System.Reflection.MemberInfo memberInfo, Type dataContractType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object GetCustomDataToExport(class System.Reflection.MemberInfo memberInfo, class System.Type dataContractType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="memberInfo" Type="System.Reflection.MemberInfo" />
<Parameter Name="dataContractType" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>During schema export operations, inserts annotations into the schema for non-null return values. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An object that represents the annotation to be inserted into the XML schema definition. </para>
</returns>
<param name="memberInfo">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MemberInfo" /> that describes the member. </param>
<param name="dataContractType">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" />. </param>
</Docs>
</Member>
<Member MemberName="GetCustomDataToExport">
<MemberSignature Language="C#" Value="public object GetCustomDataToExport (Type clrType, Type dataContractType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object GetCustomDataToExport(class System.Type clrType, class System.Type dataContractType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="clrType" Type="System.Type" />
<Parameter Name="dataContractType" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>During schema export operations, inserts annotations into the schema for non-null return values. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An object that represents the annotation to be inserted into the XML schema definition. </para>
</returns>
<param name="clrType">
<attribution license="cc4" from="Microsoft" modified="false" />The CLR type to be replaced. </param>
<param name="dataContractType">
<attribution license="cc4" from="Microsoft" modified="false" />The data contract type to be annotated. </param>
</Docs>
</Member>
<Member MemberName="GetDataContractType">
<MemberSignature Language="C#" Value="public Type GetDataContractType (Type type);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Type GetDataContractType(class System.Type type) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>During serialization, deserialization, and schema import and export, returns a data contract type that substitutes the specified type. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Type" /> to substitute for the <paramref name="type" /> value. This type must be serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. For example, it must be marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute or other mechanisms that the serializer recognizes.</para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The CLR type <see cref="T:System.Type" /> to substitute. </param>
</Docs>
</Member>
<Member MemberName="GetDeserializedObject">
<MemberSignature Language="C#" Value="public object GetDeserializedObject (object obj, Type targetType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object GetDeserializedObject(object obj, class System.Type targetType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="obj" Type="System.Object" />
<Parameter Name="targetType" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>In a simple implementation, use an if…then…else control structure to test whether the <paramref name="obj" /> value is of the surrogated type. If so, transform it as necessary and return the substituted object. The substituted object can be a new instance or the same <paramref name="obj" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>During deserialization, returns an object that is a substitute for the specified object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The substituted deserialized object. This object must be of a type that is serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. For example, it must be marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute or other mechanisms that the serializer recognizes.</para>
</returns>
<param name="obj">
<attribution license="cc4" from="Microsoft" modified="false" />The deserialized object to be substituted.</param>
<param name="targetType">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that the substituted object should be assigned to. </param>
</Docs>
</Member>
<Member MemberName="GetKnownCustomDataTypes">
<MemberSignature Language="C#" Value="public void GetKnownCustomDataTypes (System.Collections.ObjectModel.Collection&lt;Type&gt; customDataTypes);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void GetKnownCustomDataTypes(class System.Collections.ObjectModel.Collection`1&lt;class System.Type&gt; customDataTypes) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="customDataTypes" Type="System.Collections.ObjectModel.Collection&lt;System.Type&gt;" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is required during schema export or schema import only if annotations are inserted into the schema using the <see cref="Overload:System.Runtime.Serialization.IDataContractSurrogate.GetCustomDataToExport" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Sets the collection of known types to use for serialization and deserialization of the custom data objects. </para>
</summary>
<param name="customDataTypes">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.ObjectModel.Collection`1" /> of <see cref="T:System.Type" /> to add known types to.</param>
</Docs>
</Member>
<Member MemberName="GetObjectToSerialize">
<MemberSignature Language="C#" Value="public object GetObjectToSerialize (object obj, Type targetType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object GetObjectToSerialize(object obj, class System.Type targetType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="obj" Type="System.Object" />
<Parameter Name="targetType" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method must not return null because on deserialization the data will be cast to type <see cref="T:System.Object" /> and an <see cref="T:System.InvalidCastException" /> is thrown. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>During serialization, returns an object that substitutes the specified object. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The substituted object that will be serialized. The object must be serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. For example, it must be marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute or other mechanisms that the serializer recognizes.</para>
</returns>
<param name="obj">
<attribution license="cc4" from="Microsoft" modified="false" />The object to substitute. </param>
<param name="targetType">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that the substituted object should be assigned to.</param>
</Docs>
</Member>
<Member MemberName="GetReferencedTypeOnImport">
<MemberSignature Language="C#" Value="public Type GetReferencedTypeOnImport (string typeName, string typeNamespace, object customData);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Type GetReferencedTypeOnImport(string typeName, string typeNamespace, object customData) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="typeName" Type="System.String" />
<Parameter Name="typeNamespace" Type="System.String" />
<Parameter Name="customData" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Null should be returned if a CLR type does not exist for representing the schema type. This will cause a new type to be generated during schema import.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>During schema import, returns the type referenced by the schema.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Type" /> to use for the referenced type.</para>
</returns>
<param name="typeName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the type in schema.</param>
<param name="typeNamespace">
<attribution license="cc4" from="Microsoft" modified="false" />The namespace of the type in schema.</param>
<param name="customData">
<attribution license="cc4" from="Microsoft" modified="false" />The object that represents the annotation inserted into the XML schema definition, which is data that can be used for finding the referenced type.</param>
</Docs>
</Member>
<Member MemberName="ProcessImportedType">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeTypeDeclaration ProcessImportedType (System.CodeDom.CodeTypeDeclaration typeDeclaration, System.CodeDom.CodeCompileUnit compileUnit);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.CodeDom.CodeTypeDeclaration ProcessImportedType(class System.CodeDom.CodeTypeDeclaration typeDeclaration, class System.CodeDom.CodeCompileUnit compileUnit) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeTypeDeclaration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="typeDeclaration" Type="System.CodeDom.CodeTypeDeclaration" />
<Parameter Name="compileUnit" Type="System.CodeDom.CodeCompileUnit" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The input <see cref="T:System.CodeDom.CodeTypeDeclaration" /> or other information in the <see cref="T:System.CodeDom.CodeCompileUnit" /> can be modified by the user in this method. If null is returned, it will cause the type to not be generated. If a new <see cref="T:System.CodeDom.CodeTypeDeclaration" /> is returned, it will replace the original type generated.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Processes the type that has been generated from the imported schema.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> that contains the processed type.</para>
</returns>
<param name="typeDeclaration">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> to process that represents the type declaration generated during schema import.</param>
<param name="compileUnit">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCompileUnit" /> that contains the other code generated during schema import.</param>
</Docs>
</Member>
</Members>
</Type>

64
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IExtensibleDataObject.xml Normal file
View File

@@ -0,0 +1,64 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IExtensibleDataObject" FullName="System.Runtime.Serialization.IExtensibleDataObject">
<TypeSignature Language="C#" Value="public interface IExtensibleDataObject" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract IExtensibleDataObject" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Serialization.IExtensibleDataObject" /> interface provides a single property that sets or returns a structure used to store data that is external to a data contract. The extra data is stored in an instance of the <see cref="T:System.Runtime.Serialization.ExtensionDataObject" /> class and accessed through the <see cref="P:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData" /> property. In a roundtrip operation where data is received, processed, and sent back, the extra data is sent back to the original sender intact. This is useful to store data received from future versions of the contract. If you do not implement the interface, any extra data is ignored and discarded during a roundtrip operation. </para>
<procedure>
<format type="text/html">
<h2>To use this versioning feature</h2>
</format>
<steps>
<step>
<para>Implement the <see cref="T:System.Runtime.Serialization.IExtensibleDataObject" /> interface in a class.</para>
</step>
<step>
<para>Add the <see cref="P:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData" /> property to your type.</para>
</step>
<step>
<para>Add a private member of type <see cref="T:System.Runtime.Serialization.ExtensionDataObject" /> to the class.</para>
</step>
<step>
<para>Implement get and set methods for the property using the new private member.</para>
</step>
<step>
<para>Apply the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute to the class. Set the <see cref="P:System.Runtime.Serialization.DataContractAttribute.Name" /> and <see cref="P:System.Runtime.Serialization.DataContractAttribute.Namespace" /> properties to appropriate values if necessary.</para>
</step>
</steps>
</procedure>
<para>For more information about versioning of types, see <format type="text/html"><a href="4a0700cb-5f5f-4137-8705-3a3ecf06461f">Data Contract Versioning</a></format>. For information about creating forward-compatible data contracts, see <format type="text/html"><a href="413c9044-26f8-4ecb-968c-18495ea52cd9">Forward Compatible Data Contracts</a></format>. For more information about data contracts, see <format type="text/html"><a href="a3ae7b21-c15c-4c05-abd8-f483bcbf31af">Using Data Contracts</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a data structure to store extra data encountered by the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> during deserialization of a type marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute. </para>
</summary>
</Docs>
<Members>
<Member MemberName="ExtensionData">
<MemberSignature Language="C#" Value="public System.Runtime.Serialization.ExtensionDataObject ExtensionData { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Runtime.Serialization.ExtensionDataObject ExtensionData" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.ExtensionDataObject</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the structure that contains extra data.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

46
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IgnoreDataMemberAttribute.xml Normal file
View File

@@ -0,0 +1,46 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="IgnoreDataMemberAttribute" FullName="System.Runtime.Serialization.IgnoreDataMemberAttribute">
<TypeSignature Language="C#" Value="public sealed class IgnoreDataMemberAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit IgnoreDataMemberAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Property | System.AttributeTargets.Field | System.AttributeTargets.All, AllowMultiple=false, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply the <see cref="T:System.Runtime.Serialization.IgnoreDataMemberAttribute" /> attribute to opt-out of the default <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> behavior. By default, the DataContractSerializer serializes all publicly visible types. All public read/write properties and fields of the type are serialized. You can change the default behavior by applying the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> and <see cref="T:System.Runtime.Serialization.DataMemberAttribute" /> attributes to the types and members </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public IgnoreDataMemberAttribute ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.IgnoreDataMemberAttribute" /> class. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

225
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/ImportOptions.xml Normal file
View File

@@ -0,0 +1,225 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ImportOptions" FullName="System.Runtime.Serialization.ImportOptions">
<TypeSignature Language="C#" Value="public class ImportOptions" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ImportOptions extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Runtime.Serialization.XsdDataContractImporter" /> is used to generate code from XML schema using the dnprdnshort CodeDOM. To generate an XML schema from an assembly, use the <see cref="T:System.Runtime.Serialization.XsdDataContractExporter" />. </para>
<para>For more information about importing and exporting schemas, see <format type="text/html"><a href="0da32b50-ccd9-463a-844c-7fe803d3bf44">Schema Import and Export</a></format> and <format type="text/html"><a href="b9170583-8c34-43bd-97bb-6c0c8dddeee0">Importing Schema To Generate Classes</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the options that can be set on an <see cref="T:System.Runtime.Serialization.XsdDataContractImporter" />. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ImportOptions ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.ImportOptions" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="CodeProvider">
<MemberSignature Language="C#" Value="public System.CodeDom.Compiler.CodeDomProvider CodeProvider { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.CodeDom.Compiler.CodeDomProvider CodeProvider" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.Compiler.CodeDomProvider</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To support better code generation for different languages, information about what is supported by the target language needs to be passed to the schema importer. This is done by passing an instance of the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> class, which provides a <see cref="M:System.CodeDom.Compiler.CodeDomProvider.Supports(System.CodeDom.Compiler.GeneratorSupport)" /> method to check whether it supports particular <see cref="T:System.CodeDom.Compiler.CodeGeneratorOptions" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> instance that provides the means to check whether particular options for a target language are supported.</para>
</summary>
</Docs>
</Member>
<Member MemberName="DataContractSurrogate">
<MemberSignature Language="C#" Value="public System.Runtime.Serialization.IDataContractSurrogate DataContractSurrogate { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Runtime.Serialization.IDataContractSurrogate DataContractSurrogate" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Runtime.Serialization.IDataContractSurrogate</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a data contract surrogate that can be used to modify the code generated during an import operation. </para>
</summary>
</Docs>
</Member>
<Member MemberName="EnableDataBinding">
<MemberSignature Language="C#" Value="public bool EnableDataBinding { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool EnableDataBinding" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This interface is used by dnprdnshort components, such as Windows Forms or Windows Presentation Foundation, to capture data changes for user interface updates. The generated properties raise a property-changed event when the value changes, allowing UI hooks to act accordingly. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether types in generated code should implement the <see cref="T:System.ComponentModel.INotifyPropertyChanged" /> interface.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GenerateInternal">
<MemberSignature Language="C#" Value="public bool GenerateInternal { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool GenerateInternal" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether generated code will be marked internal or public.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GenerateSerializable">
<MemberSignature Language="C#" Value="public bool GenerateSerializable { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool GenerateSerializable" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that specifies whether generated data contract classes will be marked with the <see cref="T:System.SerializableAttribute" /> attribute in addition to the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ImportXmlType">
<MemberSignature Language="C#" Value="public bool ImportXmlType { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool ImportXmlType" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Normally, importing a type that does not conform to a valid data contract schema will fail. However, when this property is set to true, all such types will be imported as types that implement the <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that determines whether all XML schema types, even those that do not conform to a data contract schema, will be imported.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Namespaces">
<MemberSignature Language="C#" Value="public System.Collections.Generic.IDictionary&lt;string,string&gt; Namespaces { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Generic.IDictionary`2&lt;string, string&gt; Namespaces" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Generic.IDictionary&lt;System.String,System.String&gt;</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a dictionary that contains the mapping of data contract namespaces to the CLR namespaces that must be used to generate code during an import operation.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ReferencedCollectionTypes">
<MemberSignature Language="C#" Value="public System.Collections.Generic.ICollection&lt;Type&gt; ReferencedCollectionTypes { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Generic.ICollection`1&lt;class System.Type&gt; ReferencedCollectionTypes" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Generic.ICollection&lt;System.Type&gt;</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, an array will be generated when importing a collection schema (unless the schema has a special annotation that mentions a different type). However, if there is a matching type in the <see cref="P:System.Runtime.Serialization.ImportOptions.ReferencedCollectionTypes" /> collection, that type will be used. For example, when importing schema that contains a list of integers, an array of integers will normally be generated. However, if the collection contains the <see cref="T:System.Collections.Generic.LinkedList`1" /> of type integer, that type will be used instead of the array.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of types that represents data contract collections that should be referenced when generating code for collections, such as lists or dictionaries of items.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ReferencedTypes">
<MemberSignature Language="C#" Value="public System.Collections.Generic.ICollection&lt;Type&gt; ReferencedTypes { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Generic.ICollection`1&lt;class System.Type&gt; ReferencedTypes" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Generic.ICollection&lt;System.Type&gt;</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a <see cref="T:System.Collections.Generic.IList`1" /> containing types referenced in generated code. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

110
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/InvalidDataContractException.xml Normal file
View File

@@ -0,0 +1,110 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="InvalidDataContractException" FullName="System.Runtime.Serialization.InvalidDataContractException">
<TypeSignature Language="C#" Value="public class InvalidDataContractException : Exception" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit InvalidDataContractException extends System.Exception" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Exception</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of this type will be thrown if the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> or <see cref="T:System.Runtime.Serialization.NetDataContractSerializer" /> detects that the type of the instance being serialized or deserialized is invalid. An instance of this type will also be thrown if an invalid type is passed to the schema import or export engine. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The exception that is thrown when the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> or <see cref="T:System.Runtime.Serialization.NetDataContractSerializer" /> encounters an invalid data contract during serialization and deserialization. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public InvalidDataContractException ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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.Runtime.Serialization.InvalidDataContractException" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public InvalidDataContractException (string message);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="message" 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.Runtime.Serialization.InvalidDataContractException" /> class with the specified error message. </para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />A description of the error. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected InvalidDataContractException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is used in deserialization by one of the formatters in the <see cref="N:System.Runtime.Serialization" /> namespace. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.InvalidDataContractException" /> class with the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> and <see cref="T:System.Runtime.Serialization.StreamingContext" />. </para>
</summary>
<param name="info">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that contains data needed to serialize and deserialize an object. </param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.StreamingContext" /> that specifies user context during serialization and deserialization.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public InvalidDataContractException (string message, Exception innerException);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, class System.Exception innerException) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="message" Type="System.String" />
<Parameter Name="innerException" Type="System.Exception" />
</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.Runtime.Serialization.InvalidDataContractException" /> class with the specified error message and inner exception. </para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />A description of the error. </param>
<param name="innerException">
<attribution license="cc4" from="Microsoft" modified="false" />The original <see cref="T:System.Exception" />. </param>
</Docs>
</Member>
</Members>
</Type>

119
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/KnownTypeAttribute.xml Normal file
View File

@@ -0,0 +1,119 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="KnownTypeAttribute" FullName="System.Runtime.Serialization.KnownTypeAttribute">
<TypeSignature Language="C#" Value="public sealed class KnownTypeAttribute : Attribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit KnownTypeAttribute extends System.Attribute" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.All, AllowMultiple=true, Inherited=true)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Apply the <see cref="T:System.Runtime.Serialization.KnownTypeAttribute" /> attribute to a type to indicate to the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> types that should be recognized when serializing or deserializing an instance of the type to which the attribute is applied. This attribute could also be recognized by other serializers that understand data contracts.</para>
<block subset="none" type="note">
<para>In your code, you can use the word KnownType instead of the longer KnownTypeAttribute. </para>
</block>
<para>You can either apply exactly one <see cref="T:System.Runtime.Serialization.KnownTypeAttribute" /> instance with the <see cref="P:System.Runtime.Serialization.KnownTypeAttribute.MethodName" /> property set, or one or more <see cref="T:System.Runtime.Serialization.KnownTypeAttribute" /> instances with the <see cref="P:System.Runtime.Serialization.KnownTypeAttribute.Type" /> property set.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies types that should be recognized by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> when serializing or deserializing a given type. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public KnownTypeAttribute (string methodName);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string methodName) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="methodName" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor uses a method name that matches a method of the class. The method returns a <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Type" /> objects. During serialization or deserialization, the types found in the collection can be used within the root type to which the attribute is applied.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.KnownTypeAttribute" /> class with the name of a method that returns an <see cref="T:System.Collections.IEnumerable" /> of known types. </para>
</summary>
<param name="methodName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the method that returns an <see cref="T:System.Collections.IEnumerable" /> of types used when serializing or deserializing data.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public KnownTypeAttribute (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>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="type" Type="System.Type" />
</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.Runtime.Serialization.KnownTypeAttribute" /> class with the specified type. </para>
</summary>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that is included as a known type when serializing or deserializing data.</param>
</Docs>
</Member>
<Member MemberName="MethodName">
<MemberSignature Language="C#" Value="public string MethodName { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string MethodName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The method must exist on the class or structure that the <see cref="T:System.Runtime.Serialization.KnownTypeAttribute" /> is applied to, must be static, must accept no parameters, and must return an instance of any type that implements the generic <see cref="T:System.Collections.Generic.IEnumerable`1" /> interface, such as the <see cref="T:System.Collections.ObjectModel.Collection`1" /> class, or an array of <see cref="T:System.Type" /> objects.</para>
<para>The method is called once per application domain when the data contract is loaded for the type. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the name of a method that will return a list of types that should be recognized during serialization or deserialization. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Type">
<MemberSignature Language="C#" Value="public Type Type { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Type Type" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the type that should be recognized during serialization or deserialization by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. </para>
</summary>
</Docs>
</Member>
</Members>
</Type>

570
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/NetDataContractSerializer.xml Normal file
View File

File diff suppressed because it is too large Load Diff

491
mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlObjectSerializer.xml Normal file
View File

@@ -0,0 +1,491 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="XmlObjectSerializer" FullName="System.Runtime.Serialization.XmlObjectSerializer">
<TypeSignature Language="C#" Value="public abstract class XmlObjectSerializer" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit XmlObjectSerializer extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.Runtime.Serialization</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Extend the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> to create your own serializer to serialize and deserialize objects. Both the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> class and the <see cref="T:System.Runtime.Serialization.NetDataContractSerializer" /> class inherit from the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> and are used to serialize and deserialize objects that conform to data contract rules (objects created using the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> and the <see cref="T:System.Runtime.Serialization.DataMemberAttribute" />).</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the base class used to serialize objects as XML streams or documents. This class is abstract.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected XmlObjectSerializer ();" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is marked protected to allow derived classes to chain constructors.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="IsStartObject">
<MemberSignature Language="C#" Value="public abstract bool IsStartObject (System.Xml.XmlDictionaryReader reader);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance bool IsStartObject(class System.Xml.XmlDictionaryReader reader) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method checks if the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. The <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> implementation determines when to return true. Implementations may check that they are positioned on an element or look for an expected element name. One implementation of the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" />, the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />, checks that it is positioned on an element and also checks that the element name is the top level expected name for the type currently being deserialized. </para>
<para>If needed, additional attributes in the XML stream can be read while positioned on the top level element before reading XML contents using the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.ReadObject" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that specifies whether the <see cref="T:System.Xml.XmlDictionaryReader" /> is positioned over an XML element that can be read.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the reader can read the data; otherwise, false.</para>
</returns>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML stream or document.</param>
</Docs>
</Member>
<Member MemberName="IsStartObject">
<MemberSignature Language="C#" Value="public virtual bool IsStartObject (System.Xml.XmlReader reader);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance bool IsStartObject(class System.Xml.XmlReader reader) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlReader" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method checks whether the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. To return true, the found element must have an expected name. The actual expected element name depends on the implementation of the serializer. </para>
<para>With the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />, the starting element is specified in the constructor of the extension class. For an example, see the constructors for the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> class. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that specifies whether the <see cref="T:System.Xml.XmlReader" /> is positioned over an XML element that can be read. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the reader is positioned over the starting element; otherwise, false.</para>
</returns>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML stream or document.</param>
</Docs>
</Member>
<Member MemberName="ReadObject">
<MemberSignature Language="C#" Value="public virtual object ReadObject (System.IO.Stream stream);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object ReadObject(class System.IO.Stream stream) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="stream" Type="System.IO.Stream" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is a virtual method, and has a default implementation that creates a dictionary reader to read the underlying stream and deserialize it. The default implementation assumes the stream is text or XML. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reads the XML stream or document with a <see cref="T:System.IO.Stream" /> and returns the deserialized object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The deserialized object.</para>
</returns>
<param name="stream">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> used to read the XML stream or document.</param>
</Docs>
</Member>
<Member MemberName="ReadObject">
<MemberSignature Language="C#" Value="public virtual object ReadObject (System.Xml.XmlDictionaryReader reader);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object ReadObject(class System.Xml.XmlDictionaryReader reader) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is a virtual method, and has a default implementation that creates a dictionary reader to read the underlying stream and deserialize it. The default implementation assumes the stream is text or XML. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reads the XML document or stream with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The deserialized object.</para>
</returns>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML document.</param>
</Docs>
</Member>
<Member MemberName="ReadObject">
<MemberSignature Language="C#" Value="public virtual object ReadObject (System.Xml.XmlReader reader);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object ReadObject(class System.Xml.XmlReader reader) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlReader" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reads the XML document or stream with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The deserialized object.</para>
</returns>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML stream or document.</param>
</Docs>
</Member>
<Member MemberName="ReadObject">
<MemberSignature Language="C#" Value="public abstract object ReadObject (System.Xml.XmlDictionaryReader reader, bool readContentOnly);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object ReadObject(class System.Xml.XmlDictionaryReader reader, bool readContentOnly) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
<Parameter Name="readContentOnly" Type="System.Boolean" />
</Parameters>
<Docs>
<param name="readContentOnly">To be added.</param>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <paramref name="verifyObjectName" /> parameter uses the same code as the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject" /> method to determine whether the element is the start of the object.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reads the XML stream or document with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object; it also enables you to specify whether the serializer can read the data before attempting to read it.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The deserialized object.</para>
</returns>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML document.</param>
</Docs>
</Member>
<Member MemberName="ReadObject">
<MemberSignature Language="C#" Value="public virtual object ReadObject (System.Xml.XmlReader reader, bool readContentOnly);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object ReadObject(class System.Xml.XmlReader reader, bool readContentOnly) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="reader" Type="System.Xml.XmlReader" />
<Parameter Name="readContentOnly" Type="System.Boolean" />
</Parameters>
<Docs>
<param name="readContentOnly">To be added.</param>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <paramref name="verifyObjectName" /> parameter uses the same code as the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject" /> method to determine whether the element is the start of the object.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reads the XML document or stream with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object; it also enables you to specify whether the serializer can read the data before attempting to read it.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The deserialized object.</para>
</returns>
<param name="reader">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML document or stream.</param>
</Docs>
</Member>
<Member MemberName="WriteEndObject">
<MemberSignature Language="C#" Value="public abstract void WriteEndObject (System.Xml.XmlDictionaryWriter writer);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteEndObject(class System.Xml.XmlDictionaryWriter writer) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlDictionaryWriter" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the end of the object data as a closing XML element to the XML document or stream with an <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryWriter" /> used to write the XML document or stream.</param>
</Docs>
</Member>
<Member MemberName="WriteEndObject">
<MemberSignature Language="C#" Value="public virtual void WriteEndObject (System.Xml.XmlWriter writer);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteEndObject(class System.Xml.XmlWriter writer) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlWriter" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the end of the object data as a closing XML element to the XML document or stream with an <see cref="T:System.Xml.XmlWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlWriter" /> used to write the XML document or stream.</param>
</Docs>
</Member>
<Member MemberName="WriteObject">
<MemberSignature Language="C#" Value="public virtual void WriteObject (System.IO.Stream stream, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteObject(class System.IO.Stream stream, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="stream" Type="System.IO.Stream" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the complete content (start, content, and end) of the object to the XML document or stream with the specified <see cref="T:System.IO.Stream" />.</para>
</summary>
<param name="stream">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> used to write the XML document or stream.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object that contains the data to write to the stream.</param>
</Docs>
</Member>
<Member MemberName="WriteObject">
<MemberSignature Language="C#" Value="public virtual void WriteObject (System.Xml.XmlDictionaryWriter writer, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteObject(class System.Xml.XmlDictionaryWriter writer, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlDictionaryWriter" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This is a virtual method and has a default implementation that calls the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.WriteStartObject" />, <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.WriteObjectContent" />, and <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.WriteEndObject" /> methods. Because of this, this method is intended to be the most commonly used method on a serializer. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the complete content (start, content, and end) of the object to the XML document or stream with the specified <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryWriter" /> used to write the content to the XML document or stream.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object that contains the content to write.</param>
</Docs>
</Member>
<Member MemberName="WriteObject">
<MemberSignature Language="C#" Value="public virtual void WriteObject (System.Xml.XmlWriter writer, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteObject(class System.Xml.XmlWriter writer, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlWriter" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This is a virtual method, and has a default implementation that delegates writing to the <see cref="M:System.Runtime.Serialization.XmlObjectSerializer.WriteObject(System.Xml.XmlDictionaryWriter,System.Object)" /> overload.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the complete content (start, content, and end) of the object to the XML document or stream with the specified <see cref="T:System.Xml.XmlWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlWriter" /> used to write the XML document or stream.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object that contains the content to write.</param>
</Docs>
</Member>
<Member MemberName="WriteObjectContent">
<MemberSignature Language="C#" Value="public abstract void WriteObjectContent (System.Xml.XmlDictionaryWriter writer, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteObjectContent(class System.Xml.XmlDictionaryWriter writer, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlDictionaryWriter" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes only the content of the object to the XML document or stream using the specified <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryWriter" /> used to write the XML document or stream.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object that contains the content to write.</param>
</Docs>
</Member>
<Member MemberName="WriteObjectContent">
<MemberSignature Language="C#" Value="public virtual void WriteObjectContent (System.Xml.XmlWriter writer, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteObjectContent(class System.Xml.XmlWriter writer, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlWriter" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes only the content of the object to the XML document or stream with the specified <see cref="T:System.Xml.XmlWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlWriter" /> used to write the XML document or stream.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object that contains the content to write.</param>
</Docs>
</Member>
<Member MemberName="WriteStartObject">
<MemberSignature Language="C#" Value="public abstract void WriteStartObject (System.Xml.XmlDictionaryWriter writer, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteStartObject(class System.Xml.XmlDictionaryWriter writer, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlDictionaryWriter" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the start of the object's data as an opening XML element using the specified <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryWriter" /> used to write the XML document.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
</Docs>
</Member>
<Member MemberName="WriteStartObject">
<MemberSignature Language="C#" Value="public virtual void WriteStartObject (System.Xml.XmlWriter writer, object graph);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void WriteStartObject(class System.Xml.XmlWriter writer, object graph) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="writer" Type="System.Xml.XmlWriter" />
<Parameter Name="graph" Type="System.Object" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the start of the object's data as an opening XML element using the specified <see cref="T:System.Xml.XmlWriter" />.</para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlWriter" /> used to write the XML document.</param>
<param name="graph">
<attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
</Docs>
</Member>
</Members>
</Type>

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