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

665
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml Normal file
View File

File diff suppressed because it is too large Load Diff

323
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml Normal file
View File

@ -0,0 +1,323 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeDomComponentSerializationService" FullName="System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService">
<TypeSignature Language="C#" Value="public sealed class CodeDomComponentSerializationService : System.ComponentModel.Design.Serialization.ComponentSerializationService" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.Design.Serialization.ComponentSerializationService</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService" /> class serializes a set of components or serializable objects into a serialization store. The store can then be deserialized at a later time. The <see cref="T:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService" /> class differs from other serialization schemes in that the serialization format is opaque, and it allows for partial serialization of objects. For example, you can choose to serialize only selected properties for an object.</para>
<para>The base class, <see cref="T:System.ComponentModel.Design.Serialization.ComponentSerializationService" />, replaces the <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationService" /> interface from the .NET Framework version 1.0, although the latter is retained for backward compatibility. The <see cref="T:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService" /> class does not implement the <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationService" /> interface, but if you query for <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationService" />, the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader" /> provides a bridge implementation to ensure backward compatibility.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes a set of components into a serialization store.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomComponentSerializationService ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.CodeDomComponentSerializationService" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomComponentSerializationService (IServiceProvider provider);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="provider" Type="System.IServiceProvider" />
</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.ComponentModel.Design.Serialization.CodeDomComponentSerializationService" /> class using the given service provider to resolve services.</para>
</summary>
<param name="provider">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IServiceProvider" /> to use for resolving services.</param>
</Docs>
</Member>
<Member MemberName="CreateStore">
<MemberSignature Language="C#" Value="public override System.ComponentModel.Design.Serialization.SerializationStore CreateStore ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.Design.Serialization.SerializationStore</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The serialization store can be passed to any of the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.Serialize(System.ComponentModel.Design.Serialization.SerializationStore,System.Object)" /> methods to build up serialization state for a group of objects.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a new <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A new serialization store.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Deserialize">
<MemberSignature Language="C#" Value="public override System.Collections.ICollection Deserialize (System.ComponentModel.Design.Serialization.SerializationStore store);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.ICollection</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deserializes the given store to produce a collection of objects.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A collection of deserialized components.</para>
</returns>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from which objects will be deserialized.</param>
</Docs>
</Member>
<Member MemberName="Deserialize">
<MemberSignature Language="C#" Value="public override System.Collections.ICollection Deserialize (System.ComponentModel.Design.Serialization.SerializationStore store, System.ComponentModel.IContainer container);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.ICollection</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
<Parameter Name="container" Type="System.ComponentModel.IContainer" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Created objects that implement the <see cref="T:System.ComponentModel.IComponent" /> interface will be added to the <paramref name="container" /> parameter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deserializes the given store and populates the given <see cref="T:System.ComponentModel.IContainer" /> with deserialized <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A collection of deserialized components.</para>
</returns>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from which objects will be deserialized.</param>
<param name="container">
<attribution license="cc4" from="Microsoft" modified="false" />A container to which <see cref="T:System.ComponentModel.IComponent" /> objects will be added.</param>
</Docs>
</Member>
<Member MemberName="DeserializeTo">
<MemberSignature Language="C#" Value="public override void DeserializeTo (System.ComponentModel.Design.Serialization.SerializationStore store, System.ComponentModel.IContainer container, bool validateRecycledTypes, bool applyDefaults);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
<Parameter Name="container" Type="System.ComponentModel.IContainer" />
<Parameter Name="validateRecycledTypes" Type="System.Boolean" />
<Parameter Name="applyDefaults" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.DeserializeTo(System.ComponentModel.Design.Serialization.SerializationStore,System.ComponentModel.IContainer,System.Boolean,System.Boolean)" /> method deserializes the given store, but rather than producing new objects, the data in the store is applied to an existing set of objects that are taken from the <paramref name="container" /> parameter. As a result, the caller can create in advance an object however it sees fit. If an object has deserialization state and the object is not named in the set of existing objects, a new object will be created. If that object also implements <see cref="T:System.ComponentModel.IComponent" />, it will be added to the given container. Objects in the container must have names and types that match objects in the serialization store in order for an existing object to be used.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deserializes the given <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to the given container, optionally applying default property values.</para>
</summary>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from which the objects will be deserialized.</param>
<param name="container">
<attribution license="cc4" from="Microsoft" modified="false" />A container of objects to which data will be applied.</param>
<param name="validateRecycledTypes">
<attribution license="cc4" from="Microsoft" modified="false" />true to validate the recycled type; otherwise, false.</param>
<param name="applyDefaults">
<attribution license="cc4" from="Microsoft" modified="false" />true to apply default property values; otherwise, false.</param>
</Docs>
</Member>
<Member MemberName="LoadStore">
<MemberSignature Language="C#" Value="public override System.ComponentModel.Design.Serialization.SerializationStore LoadStore (System.IO.Stream stream);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.Design.Serialization.SerializationStore</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="stream" Type="System.IO.Stream" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You can use the returned store to deserialize objects by passing it to the various <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.Deserialize" /> methods.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Loads a <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from the given stream.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The loaded <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</para>
</returns>
<param name="stream">
<attribution license="cc4" from="Microsoft" modified="false" />The stream from which to load the <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</param>
</Docs>
</Member>
<Member MemberName="Serialize">
<MemberSignature Language="C#" Value="public override void Serialize (System.ComponentModel.Design.Serialization.SerializationStore store, object value);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <paramref name="store" /> parameter can be used to serialize more than one object by calling this method once for each object.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given object to the given <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</para>
</summary>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to which <paramref name="value" /> will be serialized. </param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
</Docs>
</Member>
<Member MemberName="SerializeAbsolute">
<MemberSignature Language="C#" Value="public override void SerializeAbsolute (System.ComponentModel.Design.Serialization.SerializationStore store, object value);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The store can be used to serialize more than one object by calling this method more than once.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given object, accounting for default property values.</para>
</summary>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to which <paramref name="value" /> will be serialized. </param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
</Docs>
</Member>
<Member MemberName="SerializeMember">
<MemberSignature Language="C#" Value="public override void SerializeMember (System.ComponentModel.Design.Serialization.SerializationStore store, object owningObject, System.ComponentModel.MemberDescriptor member);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
<Parameter Name="owningObject" Type="System.Object" />
<Parameter Name="member" Type="System.ComponentModel.MemberDescriptor" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method can be invoked multiple times for the same object to build up a list of serialized members within the serialization store. The member generally has to be a property or an event.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given member on the given object.</para>
</summary>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to which <paramref name="member" /> will be serialized. </param>
<param name="owningObject">
<attribution license="cc4" from="Microsoft" modified="false" />The object that owns the <paramref name="member" />.</param>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />The given member.</param>
</Docs>
</Member>
<Member MemberName="SerializeMemberAbsolute">
<MemberSignature Language="C#" Value="public override void SerializeMemberAbsolute (System.ComponentModel.Design.Serialization.SerializationStore store, object owningObject, System.ComponentModel.MemberDescriptor member);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
<Parameter Name="owningObject" Type="System.Object" />
<Parameter Name="member" Type="System.ComponentModel.MemberDescriptor" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For some members, containing the default property value and setting the same value back to the member are different concepts. For example, if a property inherits its value from a parent object if no local value is set, setting the value back to the property may not be what is desired. The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.SerializeMemberAbsolute(System.ComponentModel.Design.Serialization.SerializationStore,System.Object,System.ComponentModel.MemberDescriptor)" /> method takes this into account and would clear the state of the property in this case.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given member on the given object, but also serializes the member if it contains the default property value.</para>
</summary>
<param name="store">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to which <paramref name="member" /> will be serialized. </param>
<param name="owningObject">
<attribution license="cc4" from="Microsoft" modified="false" />The object that owns the <paramref name="member" />.</param>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />The given member.</param>
</Docs>
</Member>
</Members>
</Type>

537
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml Normal file
View File

File diff suppressed because it is too large Load Diff

68
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationModel.xml Normal file
View File

@ -0,0 +1,68 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeDomLocalizationModel" FullName="System.ComponentModel.Design.Serialization.CodeDomLocalizationModel">
<TypeSignature Language="C#" Value="public enum CodeDomLocalizationModel" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.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>Determines the localization model to be used by the CodeDom resource adapter.</para>
</summary>
</Docs>
<Members>
<Member MemberName="None">
<MemberSignature Language="C#" Value="None" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.Design.Serialization.CodeDomLocalizationModel</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The localization provider should ignore localized properties. It will still write out resources for objects that do not support code generation and are serializable.</para>
</summary>
</Docs>
</Member>
<Member MemberName="PropertyAssignment">
<MemberSignature Language="C#" Value="PropertyAssignment" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.Design.Serialization.CodeDomLocalizationModel</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The localization provider will write out localized properties by assigning a resource to each property. This model is fast when the number of properties is small, but it scales poorly as the number of properties containing default values grows.</para>
</summary>
</Docs>
</Member>
<Member MemberName="PropertyReflection">
<MemberSignature Language="C#" Value="PropertyReflection" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.Design.Serialization.CodeDomLocalizationModel</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The localization provider will write localized property values into a resource file and use the <see cref="T:System.ComponentModel.ComponentResourceManager" /> class to reflect on properties by name to fill them at runtime. This uses reflection at runtime so it can be slow, but it scales better for large numbers of properties with default values.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

144
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml Normal file
View File

@ -0,0 +1,144 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeDomLocalizationProvider" FullName="System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider">
<TypeSignature Language="C#" Value="public sealed class CodeDomLocalizationProvider : IDisposable, System.ComponentModel.Design.Serialization.IDesignerSerializationProvider" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.ComponentModel.Design.Serialization.IDesignerSerializationProvider</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> class is a serialization provider that provides a localization feature. It supports serializing to resources through <see cref="T:System.ComponentModel.Design.IResourceService" />, and it adds two properties to the root component: Language and Localizable. If Localizable is set to true, this provider changes the way that component properties are generated and routes their values to a resource file. Two localization models are supported.</para>
<para>You can control the cultures that are offered and the style of localization with constructor parameters.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides CodeDOM resource serialization services. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomLocalizationProvider (IServiceProvider provider, System.ComponentModel.Design.Serialization.CodeDomLocalizationModel model);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="provider" Type="System.IServiceProvider" />
<Parameter Name="model" Type="System.ComponentModel.Design.Serialization.CodeDomLocalizationModel" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider.#ctor" /> constructor creates a new adapter and attaches it to the serialization manager. This adds itself as a serializer for resources into the serialization manager, and, if not already added, adds itself as an extender provider to the root component. </para>
<para>If the <paramref name="model" /> parameter is not <see cref="F:System.ComponentModel.Design.Serialization.CodeDomLocalizationModel.None" />, the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> provides the Language and Localizable properties.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> class. </para>
</summary>
<param name="provider">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IServiceProvider" /> used by the localization provider to add its extender properties.</param>
<param name="model">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationModel" /> value indicating the localization model to be used by the CodeDOM resource adapter </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomLocalizationProvider (IServiceProvider provider, System.ComponentModel.Design.Serialization.CodeDomLocalizationModel model, System.Globalization.CultureInfo[] supportedCultures);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="provider" Type="System.IServiceProvider" />
<Parameter Name="model" Type="System.ComponentModel.Design.Serialization.CodeDomLocalizationModel" />
<Parameter Name="supportedCultures" Type="System.Globalization.CultureInfo[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider.#ctor" /> constructor creates a new adapter and attaches it to the serialization manager. This adds itself as a serializer for resources into the serialization manager, and, if not already added, adds itself as an extender provider to the root component.</para>
<para>If the <paramref name="model" /> parameter is not <see cref="F:System.ComponentModel.Design.Serialization.CodeDomLocalizationModel.None" />, the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> provides the Language and Localizable properties.</para>
<para>If <paramref name="supportedCultures" /> is not provided, the default is all cultures that are currently installed on the computer. If an array of cultures is provided, and it includes cultures that are not installed on the computer, those cultures are not available.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> class. </para>
</summary>
<param name="provider">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IServiceProvider" /> used by the localization provider to add its extender properties.</param>
<param name="model">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationModel" /> value indicating the localization model to be used by the CodeDOM resource adapter </param>
<param name="supportedCultures">
<attribution license="cc4" from="Microsoft" modified="false" />An array of cultures that this resource adapter should support.</param>
</Docs>
</Member>
<Member MemberName="Dispose">
<MemberSignature Language="C#" Value="public void Dispose ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases all resources used by the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" />.</para>
</summary>
</Docs>
</Member>
<Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationProvider.GetSerializer">
<MemberSignature Language="C#" Value="object IDesignerSerializationProvider.GetSerializer (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, object currentSerializer, Type objectType, Type serializerType);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="currentSerializer" Type="System.Object" />
<Parameter Name="objectType" Type="System.Type" />
<Parameter Name="serializerType" Type="System.Type" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> instance is cast to an <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationProvider" /> interface.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For a description of this member, see <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationProvider.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Type,System.Type)" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of a serializer of the type requested, or null if the request cannot be satisfied.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager requesting the serializer. </param>
<param name="currentSerializer">
<attribution license="cc4" from="Microsoft" modified="false" />An instance of the current serializer of the specified type. This can be null if no serializer of the specified type exists. </param>
<param name="objectType">
<attribution license="cc4" from="Microsoft" modified="false" />The data type of the object to serialize. </param>
<param name="serializerType">
<attribution license="cc4" from="Microsoft" modified="false" />The data type of the serializer to create. </param>
</Docs>
</Member>
</Members>
</Type>

319
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml Normal file
View File

File diff suppressed because one or more lines are too long

904
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml Normal file
View File

File diff suppressed because it is too large Load Diff

183
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerException.xml Normal file
View File

@ -0,0 +1,183 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CodeDomSerializerException" FullName="System.ComponentModel.Design.Serialization.CodeDomSerializerException">
<TypeSignature Language="C#" Value="public class CodeDomSerializerException : SystemException" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.SystemException</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This exception is thrown when the serializer encounters an error. This exception allows the serializer to return information about the location and type of the error.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The exception that is thrown when line number information is available for a serialization error.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomSerializerException (Exception ex, System.CodeDom.CodeLinePragma linePragma);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="ex" Type="System.Exception" />
<Parameter Name="linePragma" Type="System.CodeDom.CodeLinePragma" />
</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.ComponentModel.Design.Serialization.CodeDomSerializerException" /> class using the specified exception and line information.</para>
</summary>
<param name="ex">
<attribution license="cc4" from="Microsoft" modified="false" />The exception to throw. </param>
<param name="linePragma">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeLinePragma" /> that indicates where the exception occurred. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomSerializerException (Exception ex, System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="ex" Type="System.Exception" />
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
</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.ComponentModel.Design.Serialization.CodeDomSerializerException" /> class. </para>
</summary>
<param name="ex">
<attribution license="cc4" from="Microsoft" modified="false" />The exception to throw. </param>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> object from which to extract the context.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected CodeDomSerializerException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
</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.ComponentModel.Design.Serialization.CodeDomSerializerException" /> class using the specified serialization data and context.</para>
</summary>
<param name="info">
<attribution license="cc4" from="Microsoft" modified="false" />Stores the data that was being used to serialize or deserialize the object that the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> was serializing or deserializing. </param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />Describes the source and destination of the stream that generated the exception, as well as a means for serialization to retain that context and an additional caller-defined context. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomSerializerException (string message, System.CodeDom.CodeLinePragma linePragma);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="message" Type="System.String" />
<Parameter Name="linePragma" Type="System.CodeDom.CodeLinePragma" />
</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.ComponentModel.Design.Serialization.CodeDomSerializerException" /> class using the specified message and line information.</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />A message describing the exception. </param>
<param name="linePragma">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeLinePragma" /> that indicates where the exception occurred. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CodeDomSerializerException (string message, System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="message" Type="System.String" />
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
</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.ComponentModel.Design.Serialization.CodeDomSerializerException" /> class. </para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />A message describing the exception. </param>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> object from which to extract the context.</param>
</Docs>
</Member>
<Member MemberName="GetObjectData">
<MemberSignature Language="C#" Value="public override void GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Sets the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object with the parameter name and additional exception information.</para>
</summary>
<param name="info">
<attribution license="cc4" from="Microsoft" modified="false" />Stores the data that was being used to serialize or deserialize the object that the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> was serializing or deserializing. </param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />Describes the source and destination of the stream that generated the exception, as well as a means for serialization to retain that context and an additional caller-defined context. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="LinePragma">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeLinePragma LinePragma { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.CodeDom.CodeLinePragma</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 line information for the error associated with this exception.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

162
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml Normal file
View File

@ -0,0 +1,162 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CollectionCodeDomSerializer" FullName="System.ComponentModel.Design.Serialization.CollectionCodeDomSerializer">
<TypeSignature Language="C#" Value="public class CollectionCodeDomSerializer : System.ComponentModel.Design.Serialization.CodeDomSerializer" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.Design.Serialization.CodeDomSerializer</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ComponentModel.Design.Serialization.CollectionCodeDomSerializer" /> class can create either statements or expressions. If the object to serialize is an array, the <see cref="T:System.ComponentModel.Design.Serialization.CollectionCodeDomSerializer" /> will create an expression and assign it to the statement in the current context stack. If the object is a collection with an AddRange or similar method, the <see cref="T:System.ComponentModel.Design.Serialization.CollectionCodeDomSerializer" /> will create a statement that calls the method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes collections.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CollectionCodeDomSerializer ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.CollectionCodeDomSerializer" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="MethodSupportsSerialization">
<MemberSignature Language="C#" Value="protected bool MethodSupportsSerialization (System.Reflection.MethodInfo method);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="method" Type="System.Reflection.MethodInfo" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Checks the <paramref name="method" /> attributes to see if they support serialization.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Verifies serialization support by the <paramref name="method" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the <paramref name="method" /> supports serialization; otherwise, false.</para>
</returns>
<param name="method">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodInfo" /> to check for serialization attributes.</param>
</Docs>
</Member>
<Member MemberName="Serialize">
<MemberSignature Language="C#" Value="public override object Serialize (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, object value);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Collections are serialized as follows:</para>
<list type="ordered">
<item>
<para>If the collection is an array, the array is written.</para>
<list type="ordered">
<item>
<para>If the collection has an AddRange method, it will be called and provided with an array.</para>
</item>
<item>
<para>If the collection has an Add method, it will be called repeatedly until all items in the collection are written.</para>
</item>
</list>
</item>
<item>
<para>If the collection is an <see cref="T:System.Collections.IList" />, the <see cref="M:System.ComponentModel.Design.Serialization.CollectionCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method will cast the collection to an <see cref="T:System.Collections.IList" /> and add through that interface.</para>
<list type="ordered">
<item>
<para>If the collection has no Add method, but is marked with <see cref="F:System.ComponentModel.DesignerSerializationVisibility.Content" />, <see cref="M:System.ComponentModel.Design.Serialization.CollectionCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will enumerate the collection and serialize each element.</para>
</item>
</list>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given collection into a CodeDOM object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A CodeDOM object representing <paramref name="value" />.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use during serialization.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
</Docs>
</Member>
<Member MemberName="SerializeCollection">
<MemberSignature Language="C#" Value="protected virtual object SerializeCollection (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, System.CodeDom.CodeExpression targetExpression, Type targetType, System.Collections.ICollection originalCollection, System.Collections.ICollection valuesToSerialize);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="targetExpression" Type="System.CodeDom.CodeExpression" />
<Parameter Name="targetType" Type="System.Type" />
<Parameter Name="originalCollection" Type="System.Collections.ICollection" />
<Parameter Name="valuesToSerialize" Type="System.Collections.ICollection" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.CodeDom.CodeExpression" /> that refers to the collection can be null.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given collection.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serialized collection if the serialization process succeeded; otherwise, null.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use during serialization.</param>
<param name="targetExpression">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeExpression" /> that refers to the collection</param>
<param name="targetType">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the collection.</param>
<param name="originalCollection">
<attribution license="cc4" from="Microsoft" modified="false" />The collection to serialize.</param>
<param name="valuesToSerialize">
<attribution license="cc4" from="Microsoft" modified="false" />The values to serialize.</param>
</Docs>
</Member>
</Members>
</Type>

954
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml Normal file
View File

File diff suppressed because it is too large Load Diff

170
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ExpressionContext.xml Normal file
View File

@ -0,0 +1,170 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ExpressionContext" FullName="System.ComponentModel.Design.Serialization.ExpressionContext">
<TypeSignature Language="C#" Value="public sealed class ExpressionContext" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.ComponentModel.Design.Serialization.ExpressionContext" /> is placed on the context stack and contains the most relevant expression during serialization. The following C# code demonstrates an assignment.</para>
<code>button1.Text = "Hello";</code>
<para>During serialization, several serializers are responsible for creating this single statement. One of those serializers is responsible for creating "Hello". There are times when that serializer may need to know the context in which it is creating its expression. In the previous example, this context is not needed. The following C# code shows a situation in which knowledge of the context is necessary.</para>
<code>button1.Text = rm.GetString("button1_Text");</code>
<para>In this case, the serializer responsible for creating the resource expression needs to be informed of the names of the target objects. The <see cref="T:System.ComponentModel.Design.Serialization.ExpressionContext" /> class can be used for this. As each serializer creates an expression and invokes a serializer to handle a smaller part of the statement as a whole, the serializer pushes an expression context on the context stack. Each expression context has a parent property that locates the next expression context on the stack. This provides a convenient traversal capability.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a means of passing context state among serializers. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ExpressionContext (System.CodeDom.CodeExpression expression, Type expressionType, object owner);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="expression" Type="System.CodeDom.CodeExpression" />
<Parameter Name="expressionType" Type="System.Type" />
<Parameter Name="owner" Type="System.Object" />
</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.ComponentModel.Design.Serialization.ExpressionContext" /> class with the given expression and owner. </para>
</summary>
<param name="expression">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression.</param>
<param name="expressionType">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression type.</param>
<param name="owner">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression owner.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ExpressionContext (System.CodeDom.CodeExpression expression, Type expressionType, object owner, object presetValue);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="expression" Type="System.CodeDom.CodeExpression" />
<Parameter Name="expressionType" Type="System.Type" />
<Parameter Name="owner" Type="System.Object" />
<Parameter Name="presetValue" Type="System.Object" />
</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.ComponentModel.Design.Serialization.ExpressionContext" /> class with a current value.</para>
</summary>
<param name="expression">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression.</param>
<param name="expressionType">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression type.</param>
<param name="owner">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression owner.</param>
<param name="presetValue">
<attribution license="cc4" from="Microsoft" modified="false" />The given code expression preset value.</param>
</Docs>
</Member>
<Member MemberName="Expression">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeExpression Expression { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeExpression</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the expression this context represents.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ExpressionType">
<MemberSignature Language="C#" Value="public Type ExpressionType { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You can use <see cref="T:System.ComponentModel.Design.Serialization.ExpressionContext" /> to determine if a cast is needed when assigning to the expression.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the <see cref="T:System.Type" /> of the expression.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Owner">
<MemberSignature Language="C#" Value="public object Owner { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the expression is a property reference to the <see cref="P:System.Windows.Forms.Control.Text" /> property of an instance of <see cref="T:System.Windows.Forms.Button" /> called button1, <see cref="P:System.ComponentModel.Design.Serialization.ExpressionContext.Owner" /> returns button1.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the object owning this expression.</para>
</summary>
</Docs>
</Member>
<Member MemberName="PresetValue">
<MemberSignature Language="C#" Value="public object PresetValue { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Contains the preset value of an expression, should one exist. For example, if the expression is a property reference expression referring to the <see cref="P:System.Windows.Forms.Control.Controls" /> property of a <see cref="T:System.Windows.Forms.Button" />, the <see cref="P:System.ComponentModel.Design.Serialization.ExpressionContext.PresetValue" /> property contains the instance of the <see cref="P:System.Windows.Forms.Control.Controls" /> property. This is because the property is read-only and preset by the object to contain a value. On the other hand, a property such as <see cref="P:System.Windows.Forms.Control.Text" /> or <see cref="P:System.Windows.Forms.Control.Visible" /> does not have a preset value and therefore the <see cref="P:System.ComponentModel.Design.Serialization.ExpressionContext.PresetValue" /> property returns null.</para>
<para>The following C# code shows how serializers can use this information to guide serialization.</para>
<para>[C#]</para>
<code>Padding p = new Padding();
p.Left = 5;
button1.Padding = p;
button1.Padding.Left = 5;</code>
<para>The serializer of the <see cref="T:System.Windows.Forms.Padding" /> structure needs to be informed if it should generate the first or second form. The first form is generated by default. The second form is only generated if there is an <see cref="T:System.ComponentModel.Design.Serialization.ExpressionContext" /> on the context stack that contains a <see cref="P:System.ComponentModel.Design.Serialization.ExpressionContext.PresetValue" /> equal to the value of the <see cref="T:System.Windows.Forms.Padding" /> currently being serialized.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the preset value of an expression.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

50
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml Normal file
View File

@ -0,0 +1,50 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ICodeDomDesignerReload" FullName="System.ComponentModel.Design.Serialization.ICodeDomDesignerReload">
<TypeSignature Language="C#" Value="public interface ICodeDomDesignerReload" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> can implement this interface to support optimized reloading by the designer. When a designer reparses a file for display, it can use this interface to improve performance.</para>
<para>To support this performance optimization method, the designer can pass a <see cref="T:System.CodeDom.CodeCompileUnit" /> that represents the document code to the <see cref="M:System.ComponentModel.Design.Serialization.ICodeDomDesignerReload.ShouldReloadDesigner(System.CodeDom.CodeCompileUnit)" /> method. <see cref="M:System.ComponentModel.Design.Serialization.ICodeDomDesignerReload.ShouldReloadDesigner(System.CodeDom.CodeCompileUnit)" /> returns a value that indicates whether the code has changed and typically, whether your code should reload the designer. Otherwise, it is unnecessary to spend time reloading the designer.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides an interface that can be used to optimize the reloading of a designer.</para>
</summary>
</Docs>
<Members>
<Member MemberName="ShouldReloadDesigner">
<MemberSignature Language="C#" Value="public bool ShouldReloadDesigner (System.CodeDom.CodeCompileUnit newTree);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="newTree" Type="System.CodeDom.CodeCompileUnit" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Indicates whether the designer should reload in order to import the specified compile unit correctly.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the designer should reload; otherwise, false.</para>
</returns>
<param name="newTree">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeCompileUnit" /> containing the designer document code. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

109
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml Normal file
View File

@ -0,0 +1,109 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="MemberCodeDomSerializer" FullName="System.ComponentModel.Design.Serialization.MemberCodeDomSerializer">
<TypeSignature Language="C#" Value="public abstract class MemberCodeDomSerializer : System.ComponentModel.Design.Serialization.CodeDomSerializerBase" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.Design.Serialization.CodeDomSerializerBase</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ComponentModel.Design.Serialization.MemberCodeDomSerializer" /> class is a "meta" serializer; that is, is a serializer that does not serialize part of the object graph, but instead serializes a reflection primitive within the object graph. For example, a <see cref="T:System.ComponentModel.Design.Serialization.MemberCodeDomSerializer" /> would be associated with a <see cref="T:System.ComponentModel.PropertyDescriptor" /> in order for it to serialize a property. <see cref="T:System.ComponentModel.Design.Serialization.MemberCodeDomSerializer" /> objects enable constructs, such as properties and events, to be logical, rather than requiring them to have a physical backing in code.</para>
<para>Unlike <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> classes, <see cref="T:System.ComponentModel.Design.Serialization.MemberCodeDomSerializer" /> objects must be able to deserialize.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the base class for serializing a reflection primitive within the object graph.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected MemberCodeDomSerializer ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.MemberCodeDomSerializer" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Serialize">
<MemberSignature Language="C#" Value="public abstract void Serialize (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, object value, System.ComponentModel.MemberDescriptor descriptor, System.CodeDom.CodeStatementCollection statements);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="descriptor" Type="System.ComponentModel.MemberDescriptor" />
<Parameter Name="statements" Type="System.CodeDom.CodeStatementCollection" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method actually performs the serialization. When the member is serialized the necessary statements will be added to the statements collection.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the given member descriptor on the given value to a statement collection.</para>
</summary>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to which the member is bound.</param>
<param name="descriptor">
<attribution license="cc4" from="Microsoft" modified="false" />The descriptor of the member to serialize.</param>
<param name="statements">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeStatementCollection" /> into which <paramref name="descriptor" /> is serialized.</param>
</Docs>
</Member>
<Member MemberName="ShouldSerialize">
<MemberSignature Language="C#" Value="public abstract bool ShouldSerialize (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, object value, System.ComponentModel.MemberDescriptor descriptor);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="descriptor" Type="System.ComponentModel.MemberDescriptor" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method returns true if the given member descriptor should be serialized, or false if there is no need to serialize the member.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines if the given member should be serialized.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true, if the member described by <paramref name="descriptor" /> should be serialized; otherwise, false.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to which the member is bound.</param>
<param name="descriptor">
<attribution license="cc4" from="Microsoft" modified="false" />The descriptor of the member to serialize.</param>
</Docs>
</Member>
</Members>
</Type>

167
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml Normal file
View File

@ -0,0 +1,167 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ObjectStatementCollection" FullName="System.ComponentModel.Design.Serialization.ObjectStatementCollection">
<TypeSignature Language="C#" Value="public sealed class ObjectStatementCollection : System.Collections.IEnumerable" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Collections.IEnumerable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Holds a table of statements that is offered by the <see cref="T:System.ComponentModel.Design.Serialization.StatementContext" />. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName="ContainsKey">
<MemberSignature Language="C#" Value="public bool ContainsKey (object statementOwner);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="statementOwner" Type="System.Object" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the table contains the given statement owner.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if <paramref name="statementOwner" /> is in the table; otherwise, false.</para>
</returns>
<param name="statementOwner">
<attribution license="cc4" from="Microsoft" modified="false" />The owner of the statement collection.</param>
</Docs>
</Member>
<Member MemberName="GetEnumerator">
<MemberSignature Language="C#" Value="public System.Collections.IDictionaryEnumerator GetEnumerator ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IDictionaryEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.ComponentModel.Design.Serialization.ObjectStatementCollection" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.ComponentModel.Design.Serialization.ObjectStatementCollection" />.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeStatementCollection this[object owner] { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeStatementCollection</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="owner" Type="System.Object" />
</Parameters>
<Docs>
<param name="owner">To be added.</param>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="Populate">
<MemberSignature Language="C#" Value="public void Populate (System.Collections.ICollection statementOwners);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="statementOwners" Type="System.Collections.ICollection" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you are the creator of the statement context, you should call the <see cref="M:System.ComponentModel.Design.Serialization.ObjectStatementCollection.Populate(System.Collections.ICollection)" /> method if you want statement tables to be used to store values for certain objects.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Populates the statement table with a collection of statement owners.</para>
</summary>
<param name="statementOwners">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of statement owners to add to the table.</param>
</Docs>
</Member>
<Member MemberName="Populate">
<MemberSignature Language="C#" Value="public void Populate (object owner);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="owner" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you are the creator of the statement context, you should call the <see cref="M:System.ComponentModel.Design.Serialization.ObjectStatementCollection.Populate(System.Object)" /> method if you want statement tables to be used to store values for certain objects.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Populates the statement table with a statement owner.</para>
</summary>
<param name="owner">
<attribution license="cc4" from="Microsoft" modified="false" />The statement owner to add to the table.</param>
</Docs>
</Member>
<Member MemberName="System.Collections.IEnumerable.GetEnumerator">
<MemberSignature Language="C#" Value="System.Collections.IEnumerator IEnumerable.GetEnumerator ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Design.Serialization.ObjectStatementCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For a description of this member, see the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

81
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/RootContext.xml Normal file
View File

@ -0,0 +1,81 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="RootContext" FullName="System.ComponentModel.Design.Serialization.RootContext">
<TypeSignature Language="C#" Value="public sealed class RootContext" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.RootContext" /> can be placed on the context stack to represent the object that is the root of the serialization hierarchy. In addition to this instance, the <see cref="T:System.ComponentModel.Design.Serialization.RootContext" /> also contains an expression that can be used to reference the <see cref="T:System.ComponentModel.Design.Serialization.RootContext" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> adds a root context to provide a definition of the root object. This class cannot be inherited</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public RootContext (System.CodeDom.CodeExpression expresion, object value);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="expresion" Type="System.CodeDom.CodeExpression" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<param name="expresion">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.ComponentModel.Design.Serialization.RootContext" /> class. </para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The root object of the object graph.</param>
</Docs>
</Member>
<Member MemberName="Expression">
<MemberSignature Language="C#" Value="public System.CodeDom.CodeExpression Expression { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeExpression</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the expression representing the root object in the object graph.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Value">
<MemberSignature Language="C#" Value="public object Value { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the root object of the object graph.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

108
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml Normal file
View File

@ -0,0 +1,108 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SerializeAbsoluteContext" FullName="System.ComponentModel.Design.Serialization.SerializeAbsoluteContext">
<TypeSignature Language="C#" Value="public sealed class SerializeAbsoluteContext" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.ComponentSerializationService" /> supports absolute serialization. This means that instead of serializing only values that differ from an object's default values, all values are serialized, allowing values to be reset to their defaults for objects that may have already been initialized. When a component serialization service wishes to indicate this behavior to <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> objects, it will place a <see cref="T:System.ComponentModel.Design.Serialization.SerializeAbsoluteContext" /> object on the context stack. The member in this context may be null, to indicate that all members are serialized, or it can indicate that only a specific member is being serialized at this time.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that serializers should handle default values. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SerializeAbsoluteContext ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Using the default constructor indicates that this context should be used for all members.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ComponentModel.Design.Serialization.SerializeAbsoluteContext" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SerializeAbsoluteContext (System.ComponentModel.MemberDescriptor member);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="member" Type="System.ComponentModel.MemberDescriptor" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If <paramref name="member" /> is null, this context will be used for all members.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ComponentModel.Design.Serialization.SerializeAbsoluteContext" /> class with the option of binding to a specific member. </para>
</summary>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />The member to which this context is bound. Can be null.</param>
</Docs>
</Member>
<Member MemberName="Member">
<MemberSignature Language="C#" Value="public System.ComponentModel.MemberDescriptor Member { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.MemberDescriptor</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the member to which this context is bound.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ShouldSerialize">
<MemberSignature Language="C#" Value="public bool ShouldSerialize (System.ComponentModel.MemberDescriptor member);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="member" Type="System.ComponentModel.MemberDescriptor" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value indicating whether the given member should be serialized in this context.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the given member should be serialized in this context; otherwise, false.</para>
</returns>
<param name="member">
<attribution license="cc4" from="Microsoft" modified="false" />The member to be examined for serialization.</param>
</Docs>
</Member>
</Members>
</Type>

57
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/StatementContext.xml Normal file
View File

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="StatementContext" FullName="System.ComponentModel.Design.Serialization.StatementContext">
<TypeSignature Language="C#" Value="public sealed class StatementContext" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Usually, statements are serialized into the statement collection that is on the context stack. You can modify this behavior by creating a statement context and calling the <see cref="Overload:System.ComponentModel.Design.Serialization.ObjectStatementCollection.Populate" /> method with a collection of objects whose statements you want stored in the statement table. As each object is serialized in the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method, it has its contents placed in the statement table and saved in the context. If you push this object on the stack, it is your responsibility to integrate the statements added to it into your own collection of statements.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a location into which statements can be serialized. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public StatementContext ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.StatementContext" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="StatementCollection">
<MemberSignature Language="C#" Value="public System.ComponentModel.Design.Serialization.ObjectStatementCollection StatementCollection { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ComponentModel.Design.Serialization.ObjectStatementCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of statements offered by the statement context.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

327
mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml Normal file
View File

@ -0,0 +1,327 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="TypeCodeDomSerializer" FullName="System.ComponentModel.Design.Serialization.TypeCodeDomSerializer">
<TypeSignature Language="C#" Value="public class TypeCodeDomSerializer : System.ComponentModel.Design.Serialization.CodeDomSerializerBase" />
<AssemblyInfo>
<AssemblyName>System.Design</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.Design.Serialization.CodeDomSerializerBase</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer" /> class performs the same tasks as a <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" />, but serializing an object through this class defines a new type.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes an object to a new type.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public TypeCodeDomSerializer ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.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.ComponentModel.Design.Serialization.TypeCodeDomSerializer" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Deserialize">
<MemberSignature Language="C#" Value="public virtual object Deserialize (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, System.CodeDom.CodeTypeDeclaration declaration);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Deserialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration)" /> method deserializes a previously serialized code type declaration. The following table shows the tasks default implementation performs.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Task</para>
</term>
<description>
<para>Description</para>
</description>
</item>
</listheader>
<item>
<term>
<para>Case Sensitivity Checks</para>
</term>
<description>
<para>The implementation searches for a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> service to decide if it should treat members as case sensitive or case insensitive.</para>
</description>
</item>
<item>
<term>
<para>Statement Sorting</para>
</term>
<description>
<para>All member variables and local variables from init methods are stored in a table. Then each statement in an init method is added to a statement collection grouped according to its left-hand side, so all statements assigning or operating on a particular variable are grouped under that variable. Variables that have no statements are discarded.</para>
</description>
</item>
<item>
<term>
<para>Deserialization</para>
</term>
<description>
<para>The statement collections for each variable are deserialized according to the variable.</para>
</description>
</item>
</list>
<para>The following table shows the services the <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Deserialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration)" /> method requires.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Service</para>
</term>
<description>
<para>Description</para>
</description>
</item>
</listheader>
<item>
<term>
<para>
<see cref="T:System.CodeDom.Compiler.CodeDomProvider" />
</para>
</term>
<description>
<para>While not strictly necessary, the service, if available, is used to determine if the serialization should be case sensitive or case insensitive.</para>
</description>
</item>
<item>
<term>
<para>
<see cref="T:System.ComponentModel.IContainer" />
</para>
</term>
<description>
<para>If an object does not exist in the name table during deserialization, a query for <see cref="T:System.ComponentModel.IContainer" /> is made. If this query succeeds, the container is checked for the object. The container is also used as a stand-in for any container argument needed by components.</para>
</description>
</item>
</list>
<para> </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deserializes the given type declaration.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The root object.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
<param name="declaration">
<attribution license="cc4" from="Microsoft" modified="false" />Type declaration to use for serialization.</param>
</Docs>
</Member>
<Member MemberName="GetInitializeMethod">
<MemberSignature Language="C#" Value="protected virtual System.CodeDom.CodeMemberMethod GetInitializeMethod (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, System.CodeDom.CodeTypeDeclaration declaration, object value);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeMemberMethod</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.GetInitializeMethod(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration,System.Object)" /> method returns the method to emit all of the initialization code for the given member. The default implementation returns an empty constructor. If the same method is to be returned for multiple values, the same instance of the method should be returned. You can use the <see cref="P:System.CodeDom.CodeObject.UserData" /> dictionary to remember methods you have created. The <paramref name="typeDecl" /> parameter can also be used to add infrastructure methods. For example, if you want to emit a separate method for each object, you need a single method that calls all of these methods in turn. This method can be added to the code type declaration as needed.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the method where statements used to serialize a member are stored.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The method used to emit all of the initialization code for the given member.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
<param name="declaration">
<attribution license="cc4" from="Microsoft" modified="false" />The type declaration to use for serialization.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The value to use for serialization.</param>
</Docs>
</Member>
<Member MemberName="GetInitializeMethods">
<MemberSignature Language="C#" Value="protected virtual System.CodeDom.CodeMemberMethod[] GetInitializeMethods (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, System.CodeDom.CodeTypeDeclaration declaration);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeMemberMethod[]</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default implementation returns a single-element array with the constructor in it.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an array of methods to be interpreted during deserialization.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.CodeDom.CodeMemberMethod" /> array of methods to be interpreted during deserialization.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
<param name="declaration">
<attribution license="cc4" from="Microsoft" modified="false" />The type declaration to use for serialization.</param>
</Docs>
</Member>
<Member MemberName="Serialize">
<MemberSignature Language="C#" Value="public virtual System.CodeDom.CodeTypeDeclaration Serialize (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, object root, System.Collections.ICollection members);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.CodeDom.CodeTypeDeclaration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="manager" Type="System.ComponentModel.Design.Serialization.IDesignerSerializationManager" />
<Parameter Name="root" Type="System.Object" />
<Parameter Name="members" Type="System.Collections.ICollection" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Collections.ICollection)" /> method serializes the given root object and optional collection of members to create a new type definition. If the <paramref name="members" /> collection contains values, these values are serialized. Values themselves may serialize as either member variables or local variables. This determination is done by searching for an extender property on the object called GenerateMember. If true, a member is generated. Otherwise, a local variable is generated. For convenience, the <paramref name="members" /> collection can contain the root object. In this case, the root object is not also added as a member or local variable. </para>
<para>The name of the returned type is taken from the root object’s name, if it was a named object. If not, a name is fabricated from the simple type name of the root class. </para>
<para>The following table shows the tasks performed by the default implementation of the <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Collections.ICollection)" /> method.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Task</para>
</term>
<description>
<para>Description</para>
</description>
</item>
</listheader>
<item>
<term>
<para>Context Seeding</para>
</term>
<description>
<para>The serialization context is initialized with data including the <see cref="T:System.ComponentModel.Design.Serialization.RootContext" /> and <see cref="T:System.CodeDom.CodeTypeDeclaration" /></para>
</description>
</item>
<item>
<term>
<para>Member Serialization</para>
</term>
<description>
<para>Next, <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Collections.ICollection)" /> walks all of the members and calls <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" />. Because serialization is done opportunistically in <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" />, this ensures that serialization is not done twice.</para>
</description>
</item>
<item>
<term>
<para>Root Serialization</para>
</term>
<description>
<para>Next, the root object is serialized and its statements are added to the statement collection.</para>
</description>
</item>
<item>
<term>
<para>Statement Integration</para>
</term>
<description>
<para>After all objects are serialized, the <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Collections.ICollection)" /> method orders the statements and adds them to a method returned from <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.GetInitializeMethod(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration,System.Object)" />. Finally, a constructor is fabricated that calls all of the methods returned from <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.GetInitializeMethod(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration,System.Object)" />.</para>
</description>
</item>
</list>
<list type="bullet">
<item>
<para />
</item>
</list>
<para>The following table shows the objects the <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Collections.ICollection)" /> method places on the context stack.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Instance</para>
</term>
<description>
<para>Description</para>
</description>
</item>
</listheader>
<item>
<term>
<para>
<see cref="T:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer" />
</para>
</term>
<description>
<para>This serializer. Deriving classes may find it useful to add public properties to this class.</para>
</description>
</item>
<item>
<term>
<para>
<see cref="T:System.CodeDom.CodeTypeDeclaration" />
</para>
</term>
<description>
<para>The type being created. Most objects do not need direct access to this.</para>
</description>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes the object root by creating a new type declaration that defines root.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> that defines the root object.</para>
</returns>
<param name="manager">
<attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
<param name="root">
<attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
<param name="members">
<attribution license="cc4" from="Microsoft" modified="false" />Optional collection of members. Can be null or empty.</param>
</Docs>
</Member>
</Members>
</Type>