diff options
| author | Joel Martinez <joelmartinez@gmail.com> | 2014-05-12 22:51:54 +0400 |
|---|---|---|
| committer | Joel Martinez <joelmartinez@gmail.com> | 2014-05-12 22:52:53 +0400 |
| commit | e9068ebf5b5237e95ba5924bd978c5d119f8290c (patch) | |
| tree | c7cf85e8501bf9705a7ada9d1d5e06a2539f7064 /mcs/class/System.Design | |
| parent | 891e93e1fe61851ef779d5b995caf2d0c3cda8ed (diff) | |
[docs] documentation import for 'returns' elements.
Diffstat (limited to 'mcs/class/System.Design')
163 files changed, 2119 insertions, 525 deletions
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml index 1602fa59924..661c83576a8 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml @@ -45,12 +45,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds a <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> that was added to the collection.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to add to the collection.</param> </Docs> @@ -68,12 +71,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptorCollection" /> contains the specified <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> is contained in the collection; otherwise, false.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to locate.</param> </Docs> @@ -116,12 +122,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of a <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptorCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> of <paramref name="value" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptorCollection" />, if found; otherwise, -1.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to locate.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml index 74fc385d358..4bf07b8ea58 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml @@ -45,12 +45,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceGroup" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds a <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> that was added to the collection.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to add to the collection.</param> </Docs> @@ -68,12 +71,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceGroup" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" /> contains the specified <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> is contained in the collection; otherwise, false.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to locate.</param> </Docs> @@ -116,12 +122,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceGroup" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of a <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> of <paramref name="value" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" />, if found; otherwise, -1.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to locate.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml index daa56da46c6..d23e9756760 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml @@ -51,7 +51,6 @@ <Parameter Name="dataSourceDescriptor" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>You should only call the <see cref="M:System.ComponentModel.Design.Data.DataSourceProviderService.AddDataSourceInstance(System.ComponentModel.Design.IDesignerHost,System.ComponentModel.Design.Data.DataSourceDescriptor)" /> method on data sources that are designable for example, if the<see cref="P:System.ComponentModel.Design.Data.DataSourceDescriptor.IsDesignable" /> value is true.</para> @@ -61,6 +60,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, creates and returns an instance of the given data source, and adds it to the design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> representing an instance of the added data source.</para> + </returns> <param name="host"> <attribution license="cc4" from="Microsoft" modified="false" />The designer host.</param> <param name="dataSourceDescriptor"> @@ -78,12 +81,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, retrieves the collection of data sources at the EnvDTE.Project level.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" />, or null if there are no data sources at the EnvDTE.Project level.</para> + </returns> </Docs> </Member> <Member MemberName="InvokeAddNewDataSource"> @@ -100,12 +106,15 @@ <Parameter Name="startPosition" Type="System.Windows.Forms.FormStartPosition" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, invokes the <ui>Add New Data Source Wizard</ui>.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> collection of newly added data sources, or null if no data sources are added.</para> + </returns> <param name="parentWindow"> <attribution license="cc4" from="Microsoft" modified="false" />The parent window.</param> <param name="startPosition"> @@ -127,12 +136,15 @@ <Parameter Name="dataSourceDescriptor" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, invokes the <ui>Configure Data Source</ui> dialog box on the specified data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if any changes were made to that data source; otherwise, false.</para> + </returns> <param name="parentWindow"> <attribution license="cc4" from="Microsoft" modified="false" />The parent window.</param> <param name="startPosition"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml index a46297ef0b6..e8ec3394b7a 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml @@ -73,7 +73,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.DesignerDataStoredProcedure.CreateParameters" /> method is called the first time the <see cref="P:System.ComponentModel.Design.Data.DesignerDataStoredProcedure.Parameters" /> property is accessed to populate the collection of stored-procedure parameters.</para> @@ -82,6 +81,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, returns a collection of parameters for the stored procedure.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of <see cref="T:System.ComponentModel.Design.Data.DesignerDataParameter" /> objects.</para> + </returns> </Docs> </Member> <Member MemberName="Name"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml index 74ac59e81de..41fa3639dbd 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml @@ -73,7 +73,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.DesignerDataTable.CreateRelationships" /> method is called the first time the <see cref="P:System.ComponentModel.Design.Data.DesignerDataTable.Relationships" /> property is accessed, to populate the collection of data table relationships.</para> @@ -82,6 +81,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, returns a collection of relationship objects.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of <see cref="T:System.ComponentModel.Design.Data.DesignerDataRelationship" /> objects.</para> + </returns> </Docs> </Member> <Member MemberName="Relationships"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml index 63c8e738981..45eab988c21 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml @@ -101,7 +101,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.DesignerDataTableBase.CreateColumns" /> method is called the first time the <see cref="P:System.ComponentModel.Design.Data.DesignerDataTableBase.Columns" /> property is accessed, to populate the collection of data-store columns.</para> @@ -110,6 +109,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, returns a collection of data-store column objects.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of <see cref="T:System.ComponentModel.Design.Data.DesignerDataColumn" /> objects.</para> + </returns> </Docs> </Member> <Member MemberName="Name"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml index f11742066d4..4e1edef66da 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml @@ -32,7 +32,6 @@ <Parameter Name="initialConnection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Use the <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.BuildConnection(System.Windows.Forms.IWin32Window,System.ComponentModel.Design.Data.DesignerDataConnection)" /> method to activate the design environment's user interface for creating or editing data connections. If the <paramref name="initialConnection" /> parameter is null, it indicates the user wants to create a new connection. If the <paramref name="initialConnection" /> parameter is a <see cref="T:System.ComponentModel.Design.Data.DesignerDataConnection" /> object, it indicates the user wants to edit an existing connection.</para> @@ -44,6 +43,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new data connection or edits an existing connection using the design tool's new connection user interface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new or edited <see cref="T:System.ComponentModel.Design.Data.DesignerDataConnection" /> object, or null if the user canceled.</para> + </returns> <param name="owner"> <attribution license="cc4" from="Microsoft" modified="false" />The parent window for the connection dialog.</param> <param name="initialConnection"> @@ -66,7 +69,6 @@ <Parameter Name="initialQueryText" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.BuildQuery(System.Windows.Forms.IWin32Window,System.ComponentModel.Design.Data.DesignerDataConnection,System.ComponentModel.Design.Data.QueryBuilderMode,System.String)" /> method launches the design environment's UI for editing or creating SQL query strings. If the <paramref name="initialQueryText" /> parameter is <see cref="F:System.String.Empty" />, it indicates the user wants to create a new query. If the <paramref name="initialQueryText" /> parameter contains a string, it indicates the user wants to edit the existing query. </para> @@ -76,6 +78,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Launches a dialog to build a SQL query string.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string containing the SQL query, or null if the user canceled.</para> + </returns> <param name="owner"> <attribution license="cc4" from="Microsoft" modified="false" />The parent window for the dialog.</param> <param name="connection"> @@ -101,7 +107,6 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.ConfigureConnection(System.Windows.Forms.IWin32Window,System.ComponentModel.Design.Data.DesignerDataConnection,System.String)" /> method writes a connection to the application's configuration file. The connection string and provider name are written to the <format type="text/html"><a href="b6ffbb2e-a4d1-410e-8f7e-9755e92c65de">connectionStrings</a></format> configuration element named according to the <paramref name="name" /> parameter. The <see cref="P:System.ComponentModel.Design.Data.DesignerDataConnection.Name" /> property of the <paramref name="connection" /> parameter is ignored. </para> @@ -153,6 +158,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Writes a connection string to the application's configuration file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.Data.DesignerDataConnection" /> object containing the saved connection data with the <see cref="P:System.ComponentModel.Design.Data.DesignerDataConnection.Name" /> property set to <paramref name="name" />, and the <see cref="P:System.ComponentModel.Design.Data.DesignerDataConnection.IsConfigured" /> property set to true.</para> + </returns> <param name="owner"> <attribution license="cc4" from="Microsoft" modified="false" />The parent window for the dialog, if any.</param> <param name="connection"> @@ -196,12 +205,15 @@ <Parameter Name="connection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a code expression that contains the source code required to retrieve a connection string from the application's configuration file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeExpression" /> object containing the source code required to retrieve a connection string from the application's configuration file.</para> + </returns> <param name="connection"> <attribution license="cc4" from="Microsoft" modified="false" />The connection to retrieve from the application's configuration file.</param> </Docs> @@ -219,7 +231,6 @@ <Parameter Name="connection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.GetConnectionSchema(System.ComponentModel.Design.Data.DesignerDataConnection)" /> method returns the database schema for the specified data connection. If the schema is unavailable, or if the provider for the connection is unavailable, the <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.GetConnectionSchema(System.ComponentModel.Design.Data.DesignerDataConnection)" /> should return null.</para> @@ -228,6 +239,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the schema for the specified data connection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.ComponentModel.Design.Data.IDesignerDataSchema" /> object containing the schema information for the specified data connection, or null if no schema information is available.</para> + </returns> <param name="connection"> <attribution license="cc4" from="Microsoft" modified="false" />The data connection for which to return schema information.</param> </Docs> @@ -245,7 +260,6 @@ <Parameter Name="connection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.GetDesignTimeConnection(System.ComponentModel.Design.Data.DesignerDataConnection)" /> method returns a valid, open connection to the data store that can be used by the control designer. </para> @@ -255,6 +269,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a database connection that can be used at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Data.Common.DbConnection" /> object that can be used at design time.</para> + </returns> <param name="connection"> <attribution license="cc4" from="Microsoft" modified="false" />The desired data connection.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml index 6bc4a3f744d..f09dc81e03b 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml @@ -31,7 +31,6 @@ <Parameter Name="schemaClass" Type="System.ComponentModel.Design.Data.DesignerDataSchemaClass" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.IDesignerDataSchema.GetSchemaItems(System.ComponentModel.Design.Data.DesignerDataSchemaClass)" /> method returns a collection of all the specified schema objects in the data store. </para> @@ -43,6 +42,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a collection of specified schema items.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of schema objects of the specified type.</para> + </returns> <param name="schemaClass"> <attribution license="cc4" from="Microsoft" modified="false" />The schema objects to return.</param> </Docs> @@ -60,7 +63,6 @@ <Parameter Name="schemaClass" Type="System.ComponentModel.Design.Data.DesignerDataSchemaClass" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Data.IDesignerDataSchema.SupportsSchemaClass(System.ComponentModel.Design.Data.DesignerDataSchemaClass)" /> method indicates whether the data store supports a specified data-schema object. If the data store does not support the specified object, the <see cref="M:System.ComponentModel.Design.Data.IDesignerDataSchema.SupportsSchemaClass(System.ComponentModel.Design.Data.DesignerDataSchemaClass)" /> method should return false.</para> @@ -70,6 +72,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether the data store contains the specified data-schema object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the data store supports the specified data-schema object; otherwise, false.</para> + </returns> <param name="schemaClass"> <attribution license="cc4" from="Microsoft" modified="false" />The schema objects to return.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml index 2003df2c3d0..54aa7c1d4fb 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml @@ -159,12 +159,15 @@ <Parameter Name="enable" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Enables or disables component notification with the <see cref="T:System.ComponentModel.Design.Serialization.DesignerLoader" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the component notification was enabled prior to this call; otherwise, false.</para> + </returns> <param name="enable"> <attribution license="cc4" from="Microsoft" modified="false" />true to enable component notification by the <see cref="T:System.ComponentModel.Design.Serialization.DesignerLoader" />; false to disable component notification by the <see cref="T:System.ComponentModel.Design.Serialization.DesignerLoader" />.</param> </Docs> @@ -203,7 +206,6 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para> @@ -213,6 +215,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service, or null if the requested service cannot be found.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the service.</param> </Docs> @@ -249,7 +255,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.BasicDesignerLoader.IsReloadNeeded" /> method is used by some designer loaders to optimize reloading. This method can be overridden if your designer loader supports intelligent reloading. Some designer loaders can detect changes made to their underlying document and determine if a reload of the designer is actually necessary. If not, they should return false from this method. The default implementation always returns true, indicating that any call to <see cref="M:System.ComponentModel.Design.Serialization.BasicDesignerLoader.Reload(System.ComponentModel.Design.Serialization.BasicDesignerLoader.ReloadOptions)" /> will succeed.</para> @@ -258,6 +263,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the designer should be reloaded.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the designer should be reloaded; otherwise, false. The default implementation always returns true.</para> + </returns> </Docs> </Member> <Member MemberName="LoaderHost"> @@ -637,7 +646,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Any object can call the <see cref="M:System.ComponentModel.Design.Serialization.BasicDesignerLoader.System#ComponentModel#Design#Serialization#IDesignerLoaderService#Reload" /> method to request that the loader reload the design document. If the loader supports reloading and complies with the reload, the designer loader can return true. Otherwise, it returns false, indicating that the reload will not occur. Callers cannot rely on the reload happening immediately; the designer loader can schedule this for some other time, or it can try to reload the designer at once.</para> @@ -647,6 +655,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Reloads the design document.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the reload request is accepted; false if the loader does not allow the reload.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml index 05d78549630..dbb2741c5eb 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml @@ -66,7 +66,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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> @@ -75,6 +74,10 @@ <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"> @@ -90,12 +93,15 @@ <Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -114,7 +120,6 @@ <Parameter Name="container" Type="System.ComponentModel.IContainer" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -123,6 +128,10 @@ <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"> @@ -176,7 +185,6 @@ <Parameter Name="stream" Type="System.IO.Stream" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -185,6 +193,10 @@ <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> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml index d36455b4f6f..94a62ad00fb 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml @@ -164,7 +164,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.IsReloadNeeded" /> method checks for the presence of the <see cref="T:System.ComponentModel.Design.Serialization.ICodeDomDesignerReload" /> interface on the <see cref="P:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.CodeDomProvider" />. The provider will reparse the CodeDOM tree and pass the resulting parse tree to the <see cref="M:System.ComponentModel.Design.Serialization.ICodeDomDesignerReload.ShouldReloadDesigner(System.CodeDom.CodeCompileUnit)" /> method. If this method returns false, the designer will not be reloaded.</para> @@ -173,6 +172,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether a reload is required.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="P:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.CodeDomProvider" /> decides a reload is required; otherwise, false.</para> + </returns> </Docs> </Member> <Member MemberName="OnBeginLoad"> @@ -284,7 +287,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.Parse" /> method is called when the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader" /> needs to parse the source code. The source code location and format must be specified by deriving classes.</para> @@ -293,6 +295,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Parses the text or other persistent storage and returns a <see cref="T:System.CodeDom.CodeCompileUnit" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeCompileUnit" /> resulting from a parse operation.</para> + </returns> </Docs> </Member> <Member MemberName="PerformFlush"> @@ -365,12 +371,15 @@ <Parameter Name="serializationData" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Deserializes the specified serialization data object and returns a collection of objects represented by that data.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of objects represented by <paramref name="serializationData" />.</para> + </returns> <param name="serializationData"> <attribution license="cc4" from="Microsoft" modified="false" />An object consisting of serialized data.</param> </Docs> @@ -388,12 +397,15 @@ <Parameter Name="objects" Type="System.Collections.ICollection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the specified collection of objects and stores them in a serialization data object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that contains the serialized state of the specified collection of objects.</para> + </returns> <param name="objects"> <attribution license="cc4" from="Microsoft" modified="false" />A collection of objects to serialize.</param> </Docs> @@ -412,12 +424,15 @@ <Parameter Name="dataType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new name that is unique to all components in the specified container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A unique name for the data type.</para> + </returns> <param name="container"> <attribution license="cc4" from="Microsoft" modified="false" />The container where the new object is added.</param> <param name="dataType"> @@ -437,12 +452,15 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified name is valid.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the name is valid; otherwise, false.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The name to validate.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml index b7f2e024981..f243fe97353 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml @@ -118,7 +118,6 @@ <Parameter Name="serializerType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -127,6 +126,10 @@ <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"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml index 3b3a73c7f81..87617f10b4e 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml @@ -73,7 +73,6 @@ <Parameter Name="codeObject" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method uses the serialization manager to create objects and resolve data types. The root of the object graph is returned.</para> @@ -82,6 +81,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Deserializes the specified serialized CodeDOM object into an object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The deserialized CodeDOM object.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />A serialization manager interface that is used during the deserialization process. </param> <param name="codeObject"> @@ -105,7 +108,6 @@ <Parameter Name="statement" Type="System.CodeDom.CodeStatement" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializer.DeserializeStatementToInstance(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeStatement)" /> is equivalent of calling <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.DeserializeStatement(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeStatement)" />, except that it returns an object instance if the resulting statement was a variable assign statement, a variable declaration with an init expression, or a field assignment statement.</para> @@ -114,6 +116,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Deserializes a single statement.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object instance resulting from deserializing <paramref name="statement" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param> <param name="statement"> @@ -135,12 +141,15 @@ <Parameter Name="targetType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines which statement group the given statement should belong to.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The name of the component with which <paramref name="statement" /> should be grouped.</para> + </returns> <param name="statement"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeStatement" /> for which to determine the group.</param> <param name="expression"> @@ -160,12 +169,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the specified object into a CodeDOM object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A CodeDOM object representing the object that has been serialized.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use during serialization. </param> <param name="value"> @@ -189,12 +201,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the given object, accounting for default values.</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 serialization manager to use for serialization.</param> <param name="value"> @@ -217,12 +232,15 @@ </Parameters> <Docs> <param name="owningobject">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the given member on the given object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeStatementCollection" /> representing the serialized state of <paramref name="member" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param> <param name="member"> @@ -245,12 +263,15 @@ </Parameters> <Docs> <param name="owningobject">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the given member, accounting for default values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A CodeDom object representing <paramref name="member" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param> <param name="member"> @@ -268,7 +289,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method is similar to <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" />, except that it stops if it cannot obtain a simple reference expression for the value. Call this method when you expect the resulting expression to be used as a parameter or target of a statement.</para> @@ -277,6 +297,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the specified value to a CodeDOM expression.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The serialized value. This returns null if no reference expression can be obtained for the specified value, or the value cannot be serialized.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use during serialization. </param> <param name="value"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml index 8fc69fc896b..c7ef3509a32 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml @@ -40,7 +40,6 @@ <Parameter Name="expression" Type="System.CodeDom.CodeExpression" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This is a helper method that derived classes can call to deserialize an expression. It deserializes the statement by interpreting and executing the CodeDOM expression specified by the <paramref name="expression" /> parameter, and then returns the results. If an object needs to be created as a result of this expression, it will be given the name specified by the <paramref name="name" /> parameter. The name can be null if there is no need to name the object. The following table describes how specific expressions are handled.</para> @@ -109,6 +108,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Deserializes the given expression into an in-memory object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object resulting from interpretation of <paramref name="expression" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> <param name="name"> @@ -134,7 +137,6 @@ <Parameter Name="addToContainer" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.DeserializeInstance(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Type,System.Object[],System.String,System.Boolean)" /> method is invoked during deserialization to obtain an instance of an object. When this is called, an instance of the requested type should be returned. The default implementation invokes the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" /> method of the <paramref name="manager" /> parameter.</para> @@ -143,6 +145,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an instance of the given type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of <paramref name="type" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> <param name="type"> @@ -232,7 +238,6 @@ </Parameters> <Docs> <param name="instance">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method returns an expression representing the given object. It can return null, indicating that no expression has been set that describes the object. Expressions are acquired in one of three ways:</para> @@ -254,6 +259,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an expression for the given object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeExpression" /> representing v<paramref name="alue" />, or null if there is no existing expression for v<paramref name="alue" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> </Docs> @@ -273,7 +282,6 @@ </Parameters> <Docs> <param name="instance">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method is an extension to the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method. The <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method takes an object type, rather than an object value. If an external party had overridden metadata for a specific object through <see cref="T:System.ComponentModel.TypeDescriptor" />, that metadata override would not be seen by the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method, which only takes a type. The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method checks the metadata of the value and the value’s type. If the two differ, <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will look to see if there is a custom designer serializer attribute on the value. If so, <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will attempt to use it. Otherwise, it will defer to <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" />.</para> @@ -282,6 +290,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Locates a serializer for the given object value.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> that is appropriate for <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 for serialization.</param> </Docs> @@ -301,7 +313,6 @@ </Parameters> <Docs> <param name="instanceType">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Type)" /> method is an extension to the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method. The <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method takes an object type, rather than an object value.</para> @@ -310,6 +321,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Locates a serializer for the given type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> that is appropriate for <paramref name="valueType" />.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> </Docs> @@ -329,7 +344,6 @@ </Parameters> <Docs> <param name="instance">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetUniqueName(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method calls the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetName(System.Object)" /> method. If this method does not return a name, then <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetUniqueName(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> uses <see cref="T:System.ComponentModel.Design.Serialization.INameCreationService" /> to fabricate a valid name for the object. If the service is not available, <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetUniqueName(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will fabricate a name based on the short type name combined with an index number to make it unique. The resulting name is associated with the serialization manager by calling the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.SetName(System.Object,System.String)" /> method before the new name is returned.</para> @@ -338,6 +352,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a unique name for the given object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A unique name for <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 for serialization.</param> </Docs> @@ -356,7 +374,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>For the <paramref name="value" /> parameter to be considered serialized, the <paramref name="manager" /> parameter or another serializer must have called the <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SetExpression" /> method to create a relationship between <paramref name="value" /> and a referring expression.</para> @@ -365,6 +382,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether the given object has been serialized.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="value" /> has been serialized; otherwise, false.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> <param name="value"> @@ -387,7 +408,6 @@ </Parameters> <Docs> <param name="instance">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>For the <paramref name="value" /> parameter to be considered serialized, the <paramref name="manager" /> parameter or another serializer must have called the <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SetExpression" /> method to create a relationship between <paramref name="value" /> and a referring expression.</para> @@ -396,6 +416,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether the given object has been serialized, optionally considering preset expressions.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="value" /> has been serialized; otherwise, false.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> <param name="honorPreset"> @@ -692,7 +716,6 @@ </Parameters> <Docs> <param name="instance">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <paramref name="value" /> parameter can be null, in which case a primitive expression will be returned.</para> @@ -724,6 +747,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the given object into an expression.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeExpression" /> object if <paramref name="value" /> can be serialized; 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 for serialization.</param> </Docs> @@ -742,7 +769,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToResourceExpression" /> method is a helper method that serializes a value to a resource expression. This is in contrast to the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeResource(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.String,System.Object)" /> method, which writes a value to a resource binary object. <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToResourceExpression" /> goes one step further and returns an expression that can be used to recover the resource. For example, the return value might be "rm.GetValue("SomeBitmap");". The name of the resource is calculated from the <see cref="T:System.ComponentModel.Design.Serialization.ExpressionContext" />, if one can be found on the context stack. </para> @@ -766,6 +792,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the given object into an expression.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeExpression" /> containing <paramref name="value" /> as a serialized expression.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> <param name="value"> @@ -787,7 +817,6 @@ <Parameter Name="ensureInvariant" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <paramref name="ensureInvariant" /> parameter is true, the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToResourceExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Boolean)" /> method will also write the resource value into the invariant culture’s resource file if the current ResourceCulture is not the invariant culture..</para> @@ -796,6 +825,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the given object into an expression appropriate for the invariant culture.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeExpression" /> containing <paramref name="value" /> as a serialized expression.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param> <param name="value"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml index 52bd86c5baa..a6964de0416 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml @@ -48,7 +48,6 @@ <Parameter Name="method" Type="System.Reflection.MethodInfo" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Checks the <paramref name="method" /> attributes to see if they support serialization.</para> @@ -57,6 +56,10 @@ <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> @@ -75,7 +78,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Collections are serialized as follows:</para> @@ -105,6 +107,10 @@ <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"> @@ -128,7 +134,6 @@ <Parameter Name="valuesToSerialize" Type="System.Collections.ICollection" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -137,6 +142,10 @@ <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"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml index 2606f225b7b..093a18ae9b8 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml @@ -231,7 +231,6 @@ <Parameter Name="addToContainer" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method is called by serializers when they attempt to create an instance of a type. The default implementation creates a new instance of the type, or it may return an existing instance depending on the values of the <see cref="P:System.ComponentModel.Design.Serialization.DesignerSerializationManager.PreserveNames" /> and <see cref="P:System.ComponentModel.Design.Serialization.DesignerSerializationManager.RecycleInstances" /> properties. The <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" /> method uses reflection to create instances and will perform some generic <see cref="T:System.IConvertible" /> transformations on parameters to find a matching constructor.</para> @@ -240,6 +239,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of a type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new instance of the type specified by <paramref name="type" />.</para> + </returns> <param name="type"> <attribution license="cc4" from="Microsoft" modified="false" />The type to create an instance of.</param> <param name="arguments"> @@ -261,7 +264,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Most data within the serialization manager is transient and only lives for the life of a serialization session. When a session is disposed, serialization is considered to be complete and this transient state is cleared. This allows a single instance of a serialization manager to be used to serialize multiple object trees. Some state, including the service provider and any custom serialization providers that were added to the serialization manager, span sessions.</para> @@ -270,6 +272,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new serialization session.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.IDisposable" /> that represents a new serialization session.</para> + </returns> </Docs> </Member> <Member MemberName="Errors"> @@ -308,7 +314,6 @@ </Parameters> <Docs> <param name="componentType">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>You can request the type of serializer you would like. This method returns null if there is no serializer of the requested type for the specified object type.</para> @@ -317,6 +322,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the serializer for the given object type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The serializer for <paramref name="objectType" />, or null, if not found.</para> + </returns> <param name="serializerType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of serializer to retrieve.</param> </Docs> @@ -335,7 +344,6 @@ </Parameters> <Docs> <param name="service">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.Serialization.DesignerSerializationManager.GetService(System.Type)" /> method provides access to the underlying container or service provider that was set in the constructor.</para> @@ -344,6 +352,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service, or null if the service cannot be resolved.</para> + </returns> </Docs> </Member> <Member MemberName="GetType"> @@ -360,7 +372,6 @@ </Parameters> <Docs> <param name="name">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.ComponentModel.Design.Serialization.DesignerSerializationManager.GetType" /> method will search the service provider for an <see cref="T:System.ComponentModel.Design.ITypeResolutionService" /> and, if available, it will delegate to that service to resolve the type. If an <see cref="T:System.ComponentModel.Design.ITypeResolutionService" /> is not available, <see cref="Overload:System.ComponentModel.Design.Serialization.DesignerSerializationManager.GetType" /> will call the <see cref="M:System.Object.GetType" /> method.</para> @@ -369,6 +380,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested type, or null if the type cannot be resolved.</para> + </returns> </Docs> </Member> <Member MemberName="OnResolveName"> @@ -611,12 +626,15 @@ <Parameter Name="addToContainer" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Implements the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The newly created object instance.</para> + </returns> <param name="type"> <attribution license="cc4" from="Microsoft" modified="false" />The data type to create. </param> <param name="arguments"> @@ -640,12 +658,15 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves an instance of a created object of the specified name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the object with the given name, or null if no object by that name can be found.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the object to retrieve.</param> </Docs> @@ -664,7 +685,6 @@ </Parameters> <Docs> <param name="instance">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <see cref="M:System.ComponentModel.Design.Serialization.DesignerSerializationManager.System#ComponentModel#Design#Serialization#IDesignerSerializationManager#GetName(System.Object)" /> method cannot find a corresponding name for the <paramref name="value" /> parameter, it raises the <see cref="E:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.ResolveName" /> event before it returns null.</para> @@ -673,6 +693,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves a name for the specified object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The name of the object, or null if the object is unnamed.</para> + </returns> </Docs> </Member> <Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer"> @@ -690,12 +714,15 @@ </Parameters> <Docs> <param name="type">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a serializer of the requested type for the specified object type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the requested serializer, or null if no appropriate serializer can be located.</para> + </returns> <param name="serializerType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of the serializer to retrieve.</param> </Docs> @@ -714,12 +741,15 @@ </Parameters> <Docs> <param name="name">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a type of the specified name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the type, or null if the type cannot be loaded.</para> + </returns> </Docs> </Member> <Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationManager.Properties"> @@ -833,7 +863,6 @@ </Parameters> <Docs> <param name="service">To be added.</param> - <returns>To be added.</returns> <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.DesignerSerializationManager" /> instance is cast to an <see cref="T:System.IServiceProvider" /> interface.</para> @@ -842,6 +871,12 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see the <see cref="M:System.IServiceProvider.GetService(System.Type)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A service object of type <paramref name="serviceType" />.</para> + <para>-or-</para> + <para>null if there is no service object of type <paramref name="serviceType" />.</para> + </returns> </Docs> </Member> <Member MemberName="ValidateRecycledTypes"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml index 817e29472a8..74d1c053cd2 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml @@ -29,12 +29,15 @@ <Parameter Name="newTree" Type="System.CodeDom.CodeCompileUnit" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml index 1c62359d6bc..3b803688586 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml @@ -85,7 +85,6 @@ <Parameter Name="descriptor" Type="System.ComponentModel.MemberDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -94,6 +93,10 @@ <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"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml index 8f1753840dc..fac5598ccbf 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml @@ -34,12 +34,15 @@ <Parameter Name="statementOwner" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -55,12 +58,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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"> @@ -143,7 +149,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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> @@ -152,6 +157,10 @@ <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> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml index 5f4f55e9f7e..bcea83d27e7 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml @@ -91,12 +91,15 @@ <Parameter Name="member" Type="System.ComponentModel.MemberDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml index 0586a1b4d91..d82203741da 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml @@ -49,7 +49,6 @@ <Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -128,6 +127,10 @@ <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"> @@ -149,7 +152,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -158,6 +160,10 @@ <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"> @@ -180,7 +186,6 @@ <Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation returns a single-element array with the constructor in it.</para> @@ -189,6 +194,10 @@ <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"> @@ -210,7 +219,6 @@ <Parameter Name="members" Type="System.Collections.ICollection" /> </Parameters> <Docs> - <returns>To be added.</returns> <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> @@ -303,6 +311,10 @@ <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"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml index a1cd237fc6b..19be7b9ca7f 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml @@ -49,7 +49,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation returns the item type of the array.</para> @@ -58,6 +57,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data type that this collection is designed to contain.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Type" /> that indicates the data type that the collection is designed to contain.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -74,12 +77,15 @@ <Parameter Name="editValue" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the items in the array.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array consisting of the items within the specified array. If the object specified in the <paramref name="editValue" /> parameter is not an array, a new empty object is returned.</para> + </returns> <param name="editValue"> <attribution license="cc4" from="Microsoft" modified="false" />The array from which to retrieve the items. </param> </Docs> @@ -99,12 +105,15 @@ <Parameter Name="value" Type="System.Object[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Sets the items in the array.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the new array. If the object specified by the <paramref name="editValue" /> parameter is not an array, the object specified by the <paramref name="editValue" /> parameter is returned.</para> + </returns> <param name="editValue"> <attribution license="cc4" from="Microsoft" modified="false" />The array to set the items to. </param> <param name="value"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml index d49340f71b8..b10d25c7886 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml @@ -49,12 +49,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object using the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -77,12 +80,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editor style used by the <see cref="M:System.ComponentModel.Design.BinaryEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An enum value indicating the provided editing style.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml index 2e18a1eef17..6791ba3ace2 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml @@ -55,12 +55,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the bytes in the buffer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The unsigned byte array reference.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -75,12 +78,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the display mode for the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The display mode that this control uses. The returned value is defined in <see cref="T:System.ComponentModel.Design.DisplayMode" />.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml index 6f8400598a1..c12af0168e6 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml @@ -67,7 +67,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When implemented in a derived class, this method indicates whether the specified value can be removed from the collection. By default, this method always returns true.</para> @@ -77,6 +76,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether original members of the collection can be removed.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if it is permissible to remove this value from the collection; otherwise, false. The default implementation always returns true.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The value to remove. </param> </Docs> @@ -93,7 +96,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method indicates whether multiple collection members can be selected within the collection editor dialog box.</para> @@ -102,6 +104,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether multiple collection items can be selected at once.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if it multiple collection members can be selected at the same time; otherwise, false. By default, this returns true.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -179,12 +185,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new form to display and edit the current collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.CollectionEditor.CollectionForm" /> to provide as the user interface for editing the collection.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -199,7 +208,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>You can retrieve the data type of the items of the collection from the <see cref="P:System.ComponentModel.Design.CollectionEditor.CollectionItemType" /> property, which is faster than this method.</para> @@ -210,6 +218,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data type that this collection contains.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The data type of the items in the collection, or an <see cref="T:System.Object" /> if no Item property can be located on the collection.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -226,12 +238,15 @@ <Parameter Name="itemType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new instance of the specified collection item type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new instance of the specified object.</para> + </returns> <param name="itemType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of item to create. </param> </Docs> @@ -248,7 +263,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>You can retrieve the data type of the items of the collection from the <see cref="P:System.ComponentModel.Design.CollectionEditor.NewItemTypes" /> property, which is faster than this method.</para> @@ -259,6 +273,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data types that this collection editor can contain.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of data types that this collection can contain.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -300,12 +318,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object using the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object has not changed, this should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -332,12 +353,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the display text for the given list item.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The display text for <paramref name="value" />.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The list item for which to retrieve display text.</param> </Docs> @@ -352,12 +376,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the edit style used by the <see cref="M:System.ComponentModel.Design.CollectionEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the provided editing style. If the method is not supported in the specified context, this method will return the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" /> identifier.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> @@ -376,12 +403,15 @@ <Parameter Name="editValue" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array of objects containing the specified collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array containing the collection objects, or an empty object array if the specified collection does not inherit from <see cref="T:System.Collections.ICollection" />.</para> + </returns> <param name="editValue"> <attribution license="cc4" from="Microsoft" modified="false" />The collection to edit. </param> </Docs> @@ -404,12 +434,15 @@ <Parameter Name="instance" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a list containing the given object</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.ArrayList" /> which contains the individual objects to be created.</para> + </returns> <param name="instance"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.ArrayList" /> returned as an object.</param> </Docs> @@ -424,12 +457,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service, if it is available.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the service, or null if the service cannot be found.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve. </param> </Docs> @@ -493,7 +529,6 @@ <Parameter Name="value" Type="System.Object[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If setting requires that a new object be created, the new object is returned. Otherwise, the <paramref name="editValue" /> parameter is returned.</para> @@ -502,6 +537,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Sets the specified array as the items of the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The newly created collection object or, otherwise, the collection indicated by the <paramref name="editValue" /> parameter.</para> + </returns> <param name="editValue"> <attribution license="cc4" from="Microsoft" modified="false" />The collection to edit. </param> <param name="value"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml index 735378ef696..65458520ae0 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml @@ -236,7 +236,6 @@ </Parameters> <Docs> <param name="service">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation of this method requests the service from the site of the component.</para> @@ -245,6 +244,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Attempts to retrieve the specified type of service from the design mode site of the designer's component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing the requested service, or null if the service cannot be resolved.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -406,12 +409,15 @@ <Parameter Name="toInvoke" Type="System.ComponentModel.Design.ComponentDesigner" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the <see cref="T:System.ComponentModel.InheritanceAttribute" /> of the specified <see cref="T:System.ComponentModel.Design.ComponentDesigner" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.ComponentModel.InheritanceAttribute" /> of the specified designer.</para> + </returns> <param name="toInvoke"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.ComponentDesigner" /> whose inheritance attribute to retrieve. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml index 332292dbf65..e04a0c91196 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml @@ -46,12 +46,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified object value using the editor style provided by GetEditorStyle. A service provider is provided so that any required editing services can be obtained.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor context that can be used to provide additional context information. </param> <param name="provider"> @@ -74,12 +77,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the editing style of the <see cref="Overload:System.ComponentModel.Design.DateTimeEditor.EditValue" /> method. If the method is not supported, this will return None.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An enum value indicating the provided editing style.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor context that can be used to provide additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml index 93c52d3bb8e..cb9182c4410 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml @@ -404,7 +404,6 @@ <Parameter Name="componentType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignSurface.CreateComponent(System.Type)" /> method is called by the design surface’s <see cref="Overload:System.ComponentModel.Design.IDesignerHost.CreateComponent" /> method to create an instance of a component. The component should be created and added to the public container on the design surface.</para> @@ -413,6 +412,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of a component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The newly created component.</para> + </returns> <param name="componentType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of component to create.</param> </Docs> @@ -431,7 +434,6 @@ <Parameter Name="rootDesigner" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignSurface.CreateDesigner(System.ComponentModel.IComponent,System.Boolean)" /> method is called by the design surface’s <see cref="T:System.ComponentModel.IContainer" /> when a component is added to the container. This method creates a designer, but does not initialize it. When it returns, the designer is initialized by the container.</para> @@ -443,6 +445,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a designer when a component is added to the container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the requested designer, or null if no matching designer could be found.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component for which the designer should be created.</param> <param name="rootDesigner"> @@ -462,7 +468,6 @@ <Parameter Name="type" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If <paramref name="type" /> is an <see cref="T:System.ComponentModel.IComponent" />, <see cref="M:System.ComponentModel.Design.DesignSurface.CreateInstance(System.Type)" /> searches for a constructor of type <see cref="T:System.ComponentModel.IContainer" /> first, followed by an empty constructor.</para> @@ -471,6 +476,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of the given type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The newly created object.</para> + </returns> <param name="type"> <attribution license="cc4" from="Microsoft" modified="false" />The type to create.</param> </Docs> @@ -488,7 +497,6 @@ <Parameter Name="owningComponent" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization. </para> @@ -497,6 +505,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a container suitable for nesting controls or components.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The nested container.</para> + </returns> <param name="owningComponent"> <attribution license="cc4" from="Microsoft" modified="false" />The component that manages the nested container.</param> </Docs> @@ -515,7 +527,6 @@ <Parameter Name="containerName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization. </para> @@ -525,6 +536,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a container suitable for nesting controls or components.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The nested container.</para> + </returns> <param name="owningComponent"> <attribution license="cc4" from="Microsoft" modified="false" />The component that manages the nested container.</param> <param name="containerName"> @@ -663,7 +678,6 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignSurface.GetService(System.Type)" /> method retrieves a service in the design surface’s service container. In addition, this will forward to any service provider that was given to the design surface at construction time.</para> @@ -672,6 +686,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a service from the service container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that implements, or is a derived class of, <paramref name="serviceType" />, or null if the service does not exist in the service container.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml index 086152ef71d..2bcf325d96e 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml @@ -78,12 +78,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an enumerator that can iterate through the <see cref="T:System.ComponentModel.Design.DesignSurfaceCollection" /> instance.</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.DesignSurfaceCollection" /> instance.</para> + </returns> </Docs> </Member> <Member MemberName="Item"> @@ -207,7 +210,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.DesignSurfaceCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para> @@ -216,6 +218,10 @@ <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" /> for the <see cref="T:System.ComponentModel.Design.DesignSurfaceCollection" /> instance.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml index c8cb3966a9a..427098a2704 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml @@ -110,12 +110,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of a design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new design surface instance.</para> + </returns> </Docs> </Member> <Member MemberName="CreateDesignSurface"> @@ -131,7 +134,6 @@ <Parameter Name="parentProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If you want to conveniently add additional per-designer services, use the <paramref name="parentProvider" /> parameter to provide a service provider for this design surface. The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurface(System.IServiceProvider)" /> method creates a merged service provider that can satisfy service requests from both the given service provider as well as the <see cref="T:System.ComponentModel.Design.DesignSurfaceManager" /> itself. The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurface(System.IServiceProvider)" /> method then passes this service provider into the <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurfaceCore(System.IServiceProvider)" /> method.</para> @@ -141,6 +143,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of a design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new design surface instance.</para> + </returns> <param name="parentProvider"> <attribution license="cc4" from="Microsoft" modified="false" />A parent service provider. A new merged service provider will be created that will first ask this provider for a service, and then delegate any failures to the design surface manager object. This merged provider will be passed into the <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurfaceCore(System.IServiceProvider)" /> method.</param> </Docs> @@ -158,7 +164,6 @@ <Parameter Name="parentProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurfaceCore(System.IServiceProvider)" /> method is called by both <see cref="Overload:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurface" /> methods. It is the implementation that actually creates the design surface. The default implementation just returns a new <see cref="T:System.ComponentModel.Design.DesignSurface" />. You may override this method to provide a custom object that derives from the <see cref="T:System.ComponentModel.Design.DesignSurface" /> class.</para> @@ -167,6 +172,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Implementation that creates the design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new design surface instance.</para> + </returns> <param name="parentProvider"> <attribution license="cc4" from="Microsoft" modified="false" />A service provider to pass to the design surface. This is either an instance of <see cref="T:System.ComponentModel.Design.DesignSurfaceManager" /> or an object that implements <see cref="T:System.IServiceProvider" />, and represents a merge between the service provider of the <see cref="T:System.ComponentModel.Design.DesignSurfaceManager" /> class and an externally passed provider.</param> </Docs> @@ -294,7 +303,6 @@ </Parameters> <Docs> <param name="service">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.GetService(System.Type)" /> method forwards to any service provider that was given to the design surface manager at construction time.</para> @@ -303,6 +311,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a service in the design surface manager’s service container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that implements, or is a derived class of, the given service type; otherwise, null if the service does not exist in the service container.</para> + </returns> </Docs> </Member> <Member MemberName="SelectionChanged"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml index ce74b942a15..a679e718c7b 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml @@ -45,12 +45,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds the supplied <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to the current collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" /> index at which the value has been added.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to add.</param> </Docs> @@ -68,12 +71,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" /> contains a specific element.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" /> contains the specified value; otherwise, false.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to locate in the <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" />.</param> </Docs> @@ -116,12 +122,15 @@ <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines the index of a specific item in the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" />, if found; otherwise, -1.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to locate in the collection.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml index 3d923c64317..ac1225e2d5b 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml @@ -103,12 +103,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an object that represents a service provided by the component associated with the <see cref="T:System.ComponentModel.Design.DesignerActionList" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> that represents a service provided by the <see cref="T:System.ComponentModel.Component" />. This value is null if the <see cref="T:System.ComponentModel.Component" /> does not provide the specified service.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />A service provided by the <see cref="T:System.ComponentModel.Component" />.</param> </Docs> @@ -124,7 +127,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The virtual <see cref="M:System.ComponentModel.Design.DesignerActionList.GetSortedActionItems" /> method is implemented to return, in the expected display order, a collection of objects derived from the <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> class. These items can be of the following specific types.</para> @@ -196,6 +198,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the collection of <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> objects contained in the list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> array that contains the items in this list.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml index fb29221f7be..cad858d6441 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml @@ -109,7 +109,6 @@ <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionList" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The new element is added to the end of the internal list.</para> @@ -118,6 +117,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds the supplied <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to the current collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The position into which the new element is inserted into the collection's internal list.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to add.</param> </Docs> @@ -187,7 +190,6 @@ <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionList" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A match is determined by value, not identity, comparison.</para> @@ -196,6 +198,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the collection contains a specific value.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the collection contains the specified value; otherwise, false.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to search for.</param> </Docs> @@ -241,7 +247,6 @@ <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionList" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Internally, the <see cref="T:System.ComponentModel.Design.DesignerActionListCollection" /> class uses a <see cref="T:System.Collections.ArrayList" /> to contain its collection of <see cref="T:System.ComponentModel.Design.DesignerActionList" /> objects.</para> @@ -250,6 +255,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines the index of a specific item in the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of <paramref name="value" /> if found in the internal list; otherwise, -1.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to locate in the collection.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml index cc3d7df861e..ab94def19d1 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml @@ -178,7 +178,6 @@ <Parameter Name="comp" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignerActionService.Contains(System.ComponentModel.IComponent)" /> method only recognizes push-model smart tags, which are associated to a component with the <see cref="Overload:System.ComponentModel.Design.DesignerActionService.Add" /> method.</para> @@ -188,6 +187,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the current smart tag service manages the action lists for the specified component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the component is managed by the current service; otherwise, false.</para> + </returns> <param name="comp"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to search for.</param> </Docs> @@ -336,7 +339,6 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.DesignerActionService.GetComponentActions(System.ComponentModel.IComponent)" /> method is equivalent to a call to the <see cref="M:System.ComponentModel.Design.DesignerActionService.GetComponentActions(System.ComponentModel.IComponent,System.ComponentModel.Design.ComponentActionsType)" /> method using a <paramref name="type" /> parameter of <see cref="F:System.ComponentModel.Design.ComponentActionsType.All" />. Therefore, the collection returned will contain both the push and pull lists of smart tags.</para> @@ -346,6 +348,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the collection of smart tag item lists associated with a component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The collection of smart tags for the specified component.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component that the smart tags are associated with.</param> </Docs> @@ -364,7 +370,6 @@ <Parameter Name="type" Type="System.ComponentModel.Design.ComponentActionsType" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This version of the overloaded <see cref="Overload:System.ComponentModel.Design.DesignerActionService.GetComponentActions" /> method filters on the <paramref name="type" /> parameter, which can have one of the following values. </para> @@ -413,6 +418,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the collection of smart tag item lists of the specified type associated with a component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The collection of smart tags of the specified type for the specified component.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component that the smart tags are associated with.</param> <param name="type"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml index 5f8612a9603..b996fcd53b9 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml @@ -183,12 +183,15 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether to automatically show the smart tag panel.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true to automatically show the smart tag panel; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to automatically show.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml index 99570964dc6..b155779cb27 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml @@ -116,7 +116,6 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Although the base implementation always returns null, the overridden version supplied by the programmer should return a collection of command objects of the type described by <paramref name="name" />. The base implementation of the <see cref="P:System.ComponentModel.Design.DesignerCommandSet.Verbs" /> and <see cref="P:System.ComponentModel.Design.DesignerCommandSet.ActionLists" /> properties specify the following values and meanings for this parameter.</para> @@ -153,6 +152,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a collection of command objects.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection that contains the specified type—either <see cref="T:System.ComponentModel.Design.DesignerActionList" /> or <see cref="T:System.ComponentModel.Design.DesignerVerb" />—of command objects. The base implementation always returns null.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The type of collection to return, indicating either a <see cref="T:System.ComponentModel.Design.DesignerActionListCollection" /> or a <see cref="T:System.ComponentModel.Design.DesignerVerbCollection" />.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml index 92dbfcab72d..9f148c991bb 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml @@ -58,7 +58,6 @@ </Parameters> <Docs> <param name="eventDescriptor">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The name returned by the <see cref="M:System.ComponentModel.Design.EventBindingService.CreateUniqueMethodName(System.ComponentModel.IComponent,System.ComponentModel.EventDescriptor)" /> method must be compatible with the script language being used and it must not conflict with any other name in your code.</para> @@ -67,6 +66,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a unique method name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The unique method name.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component for which the method name will be created.</param> </Docs> @@ -116,7 +119,6 @@ </Parameters> <Docs> <param name="eventDescriptor">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Each string returned in the collection is the method name of a method whose signature is compatible with the delegate contained in <paramref name="e" />. <see cref="M:System.ComponentModel.Design.EventBindingService.GetCompatibleMethods(System.ComponentModel.EventDescriptor)" /> should return an empty collection if no names are compatible.</para> @@ -125,6 +127,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a collection of names of compatible methods.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of strings that are names of compatible methods.</para> + </returns> </Docs> </Member> <Member MemberName="GetService"> @@ -141,12 +147,15 @@ </Parameters> <Docs> <param name="service">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service from the service provider.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A reference to the service specified by <paramref name="serviceType" />, or null if the requested service is not available.</para> + </returns> </Docs> </Member> <Member MemberName="ShowCode"> @@ -160,7 +169,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.EventBindingService.ShowCode" /> method does not display any particular code; generally it displays the last code the user typed. </para> @@ -169,6 +177,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Displays user code.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if it is possible to display the code; otherwise, false.</para> + </returns> </Docs> </Member> <Member MemberName="ShowCode"> @@ -184,7 +196,6 @@ <Parameter Name="lineNumber" Type="System.Int32" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Line numbers are one-based.</para> @@ -193,6 +204,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Displays the user code at the given line number.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if it is possible to display the code; otherwise, false.</para> + </returns> <param name="lineNumber"> <attribution license="cc4" from="Microsoft" modified="false" />The line number to show.</param> </Docs> @@ -212,7 +227,6 @@ <Parameter Name="methodName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.ComponentModel.Design.EventBindingService.ShowCode(System.ComponentModel.IComponent,System.ComponentModel.EventDescriptor,System.String)" /> method displays the body of the user code with the given method name.</para> @@ -221,6 +235,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Displays the user code for the specified method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if it is possible to display the code; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to which the method is bound.</param> <param name="e"> @@ -244,12 +262,15 @@ </Parameters> <Docs> <param name="eventDescriptor">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a unique name for an event-handler method for the specified component and event.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The recommended name for the event-handler method for this event.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component instance the event is connected to.</param> </Docs> @@ -268,7 +289,6 @@ </Parameters> <Docs> <param name="eventDescriptor">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Each string returned in the collection is the method name of a method whose signature is compatible with the delegate contained in <paramref name="e" />. <see cref="M:System.ComponentModel.Design.EventBindingService.GetCompatibleMethods(System.ComponentModel.EventDescriptor)" /> should return an empty collection if no names are compatible.</para> @@ -277,6 +297,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a collection of event-handler methods that have a method signature compatible with the specified event.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of strings that are names of compatible methods.</para> + </returns> </Docs> </Member> <Member MemberName="System.ComponentModel.Design.IEventBindingService.GetEvent"> @@ -292,12 +316,15 @@ <Parameter Name="property" Type="System.ComponentModel.PropertyDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an <see cref="T:System.ComponentModel.EventDescriptor" /> for the event that the specified property descriptor represents, if it represents an event.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> for the event that the property represents, or null if the property does not represent an event.</para> + </returns> <param name="property"> <attribution license="cc4" from="Microsoft" modified="false" />The property that represents an event.</param> </Docs> @@ -315,12 +342,15 @@ <Parameter Name="events" Type="System.ComponentModel.EventDescriptorCollection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts a set of event descriptors to a set of property descriptors.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects that describe the event set.</para> + </returns> <param name="events"> <attribution license="cc4" from="Microsoft" modified="false" />The events to convert to properties.</param> </Docs> @@ -339,12 +369,15 @@ </Parameters> <Docs> <param name="eventDescriptor">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts a single event descriptor to a property descriptor.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that describes the event.</para> + </returns> </Docs> </Member> <Member MemberName="System.ComponentModel.Design.IEventBindingService.ShowCode"> @@ -358,12 +391,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Displays the user code for the designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the code is displayed; otherwise, false.</para> + </returns> </Docs> </Member> <Member MemberName="System.ComponentModel.Design.IEventBindingService.ShowCode"> @@ -379,12 +415,15 @@ <Parameter Name="lineNumber" Type="System.Int32" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Displays the user code for the designer at the specified line.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the code is displayed; otherwise, false.</para> + </returns> <param name="lineNumber"> <attribution license="cc4" from="Microsoft" modified="false" />The line number to place the caret on.</param> </Docs> @@ -404,12 +443,15 @@ </Parameters> <Docs> <param name="eventDescriptor">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Displays the user code for the specified event.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the code is displayed; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component that the event is connected to.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml index a70106c0965..622af5c251c 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml @@ -35,12 +35,15 @@ <Parameter Name="key" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a state item specified by the key for the given component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The designer state for <paramref name="component" /> specified by <paramref name="key" />.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component for which to retrieve the designer state item.</param> <param name="key"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml index 863fa33d7b3..0fec620ecef 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml @@ -163,7 +163,6 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the component is not inherited, this method returns the value <see cref="F:System.ComponentModel.InheritanceAttribute.NotInherited" />. Otherwise, it returns the inheritance attribute for this component.</para> @@ -172,6 +171,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the inheritance attribute of the specified component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.ComponentModel.InheritanceAttribute" /> that describes the level of inheritance that this component comes from.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the inheritance attribute for. </param> </Docs> @@ -191,12 +194,15 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether to ignore the specified member.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the specified member should be included in the set of inherited components; otherwise, false.</para> + </returns> <param name="member"> <attribution license="cc4" from="Microsoft" modified="false" />The member to check. This member is either a <see cref="T:System.Reflection.FieldInfo" /> or a <see cref="T:System.Reflection.MethodInfo" />. </param> <param name="component"> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml index 91738cce0b7..ba2b9205edc 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml @@ -81,12 +81,15 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this object can provide its extender properties to the specified object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if this object can provide extender properties to the specified object; otherwise, false.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The object to receive the extender properties. </param> </Docs> @@ -156,7 +159,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method returns the current resource culture used to access resource data for the specified object.</para> @@ -165,6 +167,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the current resource culture for the specified object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Globalization.CultureInfo" /> indicating the resource variety.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The object to get the current resource culture for. </param> </Docs> @@ -191,12 +197,15 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the default resource culture to use when initializing the values of a localized object at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Globalization.CultureInfo" /> indicating the resource culture to use to initialize the values of the specified object.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The object to get the resource culture for. </param> </Docs> @@ -226,12 +235,15 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified object supports resource localization.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the specified object supports resource localization; otherwise, false.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The object to check for localization support. </param> </Docs> @@ -336,12 +348,15 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified object must have its localizable values persisted in a resource.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the localizable values should be persisted in resources; otherwise, false.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The object to get the language support persistence flag for. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml index 957f304a974..1c3597b3170 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml @@ -233,12 +233,15 @@ <Parameter Name="commandID" Type="System.ComponentModel.Design.CommandID" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Searches for the <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command ID.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command; otherwise, null if the command is not found.</para> + </returns> <param name="commandID"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.CommandID" /> to find.</param> </Docs> @@ -257,12 +260,15 @@ <Parameter Name="id" Type="System.Int32" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Searches for the <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command; otherwise, null if the command is not found.</para> + </returns> <param name="guid"> <attribution license="cc4" from="Microsoft" modified="false" />The GUID of the command.</param> <param name="id"> @@ -282,12 +288,15 @@ <Parameter Name="guid" Type="System.Guid" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the command list for a given GUID.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.ICollection" /> of commands.</para> + </returns> <param name="guid"> <attribution license="cc4" from="Microsoft" modified="false" />The GUID of the command list.</param> </Docs> @@ -305,12 +314,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a reference to the requested service.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A reference to <paramref name="serviceType" />; otherwise, null if the service is not found.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the service to retrieve.</param> </Docs> @@ -328,7 +340,6 @@ <Parameter Name="commandID" Type="System.ComponentModel.Design.CommandID" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The local form is first searched for the given command ID. If it is found, it is invoked. Otherwise, the command ID is passed to the global environment command handler, if one is available.</para> @@ -337,6 +348,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Invokes the given command on the local form or in the global environment.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the command was found; otherwise, false.</para> + </returns> <param name="commandID"> <attribution license="cc4" from="Microsoft" modified="false" />The command to invoke.</param> </Docs> @@ -356,7 +371,6 @@ </Parameters> <Docs> <param name="commandID">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The local form is first searched for the given command ID. If it is found, it is invoked. Otherwise, the command ID is passed to the global environment command handler, if one is available.</para> @@ -365,6 +379,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Invokes the given command with the given parameter on the local form or in the global environment.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the command was found; otherwise, false.</para> + </returns> <param name="arg"> <attribution license="cc4" from="Microsoft" modified="false" />A parameter for the invocation.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml index f4abc7ee9a6..1ae92249ac8 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml @@ -47,12 +47,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified object value using the edit style provided by <see cref="M:System.Drawing.Design.ImageEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object has not changed, this method should return the same object passed to it.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -74,12 +77,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editing style of the <see cref="M:System.Drawing.Design.ImageEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the supported editing style.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> @@ -97,12 +103,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether this editor supports painting a representation of an object's value.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>false, indicating that this <see cref="T:System.Drawing.Design.UITypeEditor" /> does not display a visual representation in the Properties Window.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml index a4f491f1924..e431ea88a8e 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml @@ -84,7 +84,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A service provider is provided so that the editor can obtain any required services.</para> @@ -93,6 +92,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object using the editor style indicated by <see cref="Overload:System.ComponentModel.Design.ObjectSelectorEditor.GetEditStyle" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object has not changed, the method should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param> <param name="provider"> @@ -115,12 +118,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param> </Docs> @@ -162,12 +168,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editor style used by the <see cref="Overload:System.ComponentModel.Design.ObjectSelectorEditor.EditValue" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the style of editor used by <see cref="Overload:System.ComponentModel.Design.ObjectSelectorEditor.EditValue" />.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml index 17e964dadc7..3777e2c9da3 100644 --- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml +++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml @@ -142,7 +142,6 @@ <Parameter Name="primary" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation of the <see cref="M:System.ComponentModel.Design.UndoEngine.CreateUndoUnit(System.String,System.Boolean)" /> method simply returns a new <see cref="T:System.ComponentModel.Design.UndoEngine.UndoUnit" />. </para> @@ -152,6 +151,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new <see cref="T:System.ComponentModel.Design.UndoEngine.UndoUnit" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new <see cref="T:System.ComponentModel.Design.UndoEngine.UndoUnit" /> with a specified name.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the unit to create. </param> <param name="primary"> @@ -247,12 +250,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service, if found.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve.</param> </Docs> @@ -270,12 +276,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service, or null if the requested service is not found.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml b/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml index ecad95679d3..ef8e8183fce 100644 --- a/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml +++ b/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml @@ -97,12 +97,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the code member method representing the database query, as generated by the typed dataset generator.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.CodeDom.CodeMemberMethod" /> object representing the database query, as generated by the typed dataset generator.</para> + </returns> </Docs> </Member> <Member MemberName="GenerateMethodSignature"> @@ -116,12 +119,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a string representing the database query method signature, as generated by the typed dataset generator.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string representing the database query method signature, as generated by the typed dataset generator.</para> + </returns> </Docs> </Member> <Member MemberName="GenerateUpdatingMethods"> @@ -135,12 +141,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a code type declaration containing the Insert, Update, and Delete methods associated with the database query.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object containing the Insert, Update, and Delete methods associated with the database query.</para> + </returns> </Docs> </Member> <Member MemberName="IsGetMethod"> diff --git a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml index 39894de4bf3..b64510fe9e1 100644 --- a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml +++ b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml @@ -35,7 +35,6 @@ <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a strongly typed <see cref="T:System.Data.DataSet" />. The dataset is created in the namespace indicated in the <paramref name="codeNamespace" /> parameter, and the dataset is generated in the managed programming language indicated in the <paramref name="codeProvider" /> parameter.</para> @@ -44,6 +43,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on an existing <see cref="T:System.Data.DataSet" />. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para> + </returns> <param name="dataSet"> <attribution license="cc4" from="Microsoft" modified="false" />The source <see cref="T:System.Data.DataSet" /> that specifies the metadata for the typed <see cref="T:System.Data.DataSet" />.</param> <param name="codeNamespace"> @@ -68,7 +71,6 @@ <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -80,6 +82,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on the provided input file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para> + </returns> <param name="inputFileContent"> <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param> <param name="compileUnit"> @@ -118,6 +124,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on the provided input file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para> + </returns> <param name="inputFileContent"> <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param> <param name="compileUnit"> @@ -158,6 +168,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on the provided input file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para> + </returns> <param name="inputFileContent"> <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param> <param name="compileUnit"> @@ -238,7 +252,6 @@ <Parameter Name="inputFileContent" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -250,6 +263,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the first provider name found in the provided input file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that represents the specific provider for this <see cref="T:System.Data.DataSet" />.</para> + </returns> <param name="inputFileContent"> <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param> </Docs> @@ -268,7 +285,6 @@ <Parameter Name="tableName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -280,6 +296,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the provider name for the <paramref name="tableName" /> in the input file.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that represents the provider name for the specific table passed in to the <paramref name="tableName" /> parameter.</para> + </returns> <param name="inputFileContent"> <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param> <param name="tableName"> diff --git a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml index 1d49cab94f6..13758874320 100644 --- a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml +++ b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml @@ -73,7 +73,6 @@ <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -85,6 +84,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates internal type mapping information for an element defined in an XML schema document.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Returns a <see cref="T:System.String" /> representing the name of the typed dataset class.</para> + </returns> <param name="type"> <attribution license="cc4" from="Microsoft" modified="false" />XMLSchemaType</param> <param name="context"> @@ -124,7 +127,6 @@ <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -136,6 +138,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates internal type mapping information for an element defined in an XML schema document.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Returns a <see cref="T:System.String" /> representing the name of the typed dataset class.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing the name of the schema to import.</param> <param name="namespaceName"> diff --git a/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml b/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml index d17f453f167..ea71d486aa2 100644 --- a/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml @@ -49,12 +49,15 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this converter can convert an object of the given type to the type of this converter, using the specified context. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the conversion can be performed; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param> <param name="sourceType"> @@ -77,12 +80,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the given object to a string, using the specified context and culture information.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> that represents the converted value.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context.</param> <param name="culture"> @@ -105,7 +111,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para> @@ -114,6 +119,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a collection of standard values for the data type this validator is designed for.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param> </Docs> @@ -132,7 +141,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para> @@ -141,6 +149,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this object supports a standard set of values that can be picked from a list using the specified context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true because <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports. This method never returns false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml b/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml index 18bf330d0cd..69aa248866e 100644 --- a/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml +++ b/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml @@ -156,7 +156,6 @@ <Parameter Name="provider" Type="System.CodeDom.Compiler.CodeDomProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <paramref name="key" /> parameter is a valid string of characters, that string is returned. If the <paramref name="key" /> parameter is an invalid string or a string that contains invalid characters, the <see cref="M:System.Resources.Tools.StronglyTypedResourceBuilder.VerifyResourceName(System.String,System.CodeDom.Compiler.CodeDomProvider)" /> method attempts to generate a valid string based on the <paramref name="key" /> and <paramref name="provider" /> parameters. If a valid string can be generated, that string is returned; otherwise, null is returned.</para> @@ -170,6 +169,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a valid resource string based on the specified input string and code provider.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A valid resource name derived from the <paramref name="key" /> parameter. Any invalid tokens are replaced with the underscore (_) character, or null if the derived string still contains invalid characters according to the language specified by the <paramref name="provider" /> parameter.</para> + </returns> <param name="key"> <attribution license="cc4" from="Microsoft" modified="false" />The string to verify and, if necessary, convert to a valid resource name.</param> <param name="provider"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml index 7df68e95473..319d5deecdc 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml @@ -45,12 +45,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates the markup that is used to render the control on the design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup that represents the control on the design surface.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml index 13c903dd0fa..98d3a28f7d3 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml @@ -50,7 +50,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The implementation of the <see cref="M:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner.ConnectToDataSource" /> method typically involves unhooking events from the previous data source, and then attaching new events to the new data source.</para> @@ -59,6 +58,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, typically unhooks events from the previous data source, and then attaches new events to the new data source. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if a connection to a new data source was performed, typically; false if the old and new data sources are the same.</para> + </returns> </Docs> </Member> <Member MemberName="CreateDataSource"> @@ -200,7 +203,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner" /> class retrieves sample data that is used for binding purposes at design time before rendering the control. If the control is not data bound, it calls the <see cref="M:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner.GetEmptyDesignTimeHtml" /> method. If there is an error rendering the control, it calls the <see cref="M:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner.GetErrorDesignTimeHtml(System.Exception)" /> method.</para> @@ -209,6 +211,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates the markup that is used to render the control at design time. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup used to render the control at design time.</para> + </returns> </Docs> </Member> <Member MemberName="GetEmptyDesignTimeHtml"> @@ -222,7 +228,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner" /> class retrieves sample data that is used for binding purposes at design time before rendering the control. The empty design-time control renders as a placeholder that contains the type name and control name.</para> @@ -231,6 +236,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides the markup that is used to render the control at design time if the control is empty or if the data source cannot be retrieved. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup used to render the control at design time with an empty data source.</para> + </returns> </Docs> </Member> <Member MemberName="GetErrorDesignTimeHtml"> @@ -246,7 +255,6 @@ <Parameter Name="e" Type="System.Exception" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The error design-time control renders as a placeholder that contains the type name, the control name, and a message describing the error.</para> @@ -255,6 +263,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides the markup that is used to render the control at design time when an error has occurred.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup used to render the control at design time when an error has occurred.</para> + </returns> <param name="e"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Exception" /> that was thrown.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml index accf497f9bf..1743dea4396 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml @@ -56,7 +56,6 @@ <Parameter Name="parent" Type="System.Windows.Forms.IWin32Window" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.Web.UI.Design.WebControls.BaseDataListComponentEditor.EditComponent" /> method gets a <see cref="T:System.Type" /> array of page control types by using the <see cref="M:System.Windows.Forms.Design.WindowsFormsComponentEditor.GetComponentEditorPages" /> method. It creates a <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" /> object, and then calls its <see cref="M:System.Windows.Forms.Design.ComponentEditorForm.ShowForm" /> method to display the component editor.</para> @@ -65,6 +64,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified component by using the specified context descriptor and parent window.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true the component was successfully edited; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> <param name="obj"> @@ -85,7 +88,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The initial page is specified when the <see cref="T:System.Web.UI.Design.WebControls.BaseDataListComponentEditor" /> object is created. </para> @@ -94,6 +96,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the index of the initial page to display in the component editor.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the initial page in the array.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml index 80418019bfa..33764ec276a 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml @@ -232,7 +232,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.DesignTimeData.GetSelectedDataSource(System.ComponentModel.IComponent,System.String,System.String)" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> and <see cref="P:System.Web.UI.WebControls.BaseDataList.DataMember" /> properties of the associated control derived from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para> @@ -241,6 +240,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data source component from the associated control container, resolved to a specific data member.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing an <see cref="T:System.Collections.IEnumerable" /> interface containing the design-time <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> of the associated control, resolved to the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataMember" /> parameter; otherwise, null if a data source is not found.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -255,7 +258,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.DesignTimeData.GetSelectedDataSource(System.ComponentModel.IComponent,System.String)" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> property of the associated control derived from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para> @@ -264,6 +266,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data source component from the associated control container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing an <see cref="T:System.Collections.IEnumerable" /> interface containing the design-time <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> property of the associated control; otherwise, null if a data source is not found.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -281,7 +287,6 @@ </Parameters> <Docs> <param name="template_name">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetTemplateContainerDataSource(System.String)" /> method calls the <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetResolvedSelectedDataSource" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> and <see cref="P:System.Web.UI.WebControls.BaseDataList.DataMember" /> properties of the associated control derived from <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para> @@ -290,6 +295,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data source of the template's container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that implements an <see cref="T:System.Collections.IEnumerable" /> interface containing a design-time <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> property.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml index fcba77b14be..ff129c501bc 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml @@ -49,7 +49,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <see cref="P:System.Web.UI.WebControls.BaseValidator.ErrorMessage" /> or <see cref="P:System.Web.UI.WebControls.BaseValidator.Text" /> property of the associated control that is derived from the <see cref="T:System.Web.UI.WebControls.BaseValidator" /> class is an empty string (""), or if the <see cref="P:System.Web.UI.WebControls.BaseValidator.Display" /> property is set to the <see cref="F:System.Web.UI.WebControls.ValidatorDisplay.None" /> field, the <see cref="M:System.Web.UI.Design.WebControls.BaseValidatorDesigner.GetDesignTimeHtml" /> method sets the <see cref="P:System.Web.UI.WebControls.BaseValidator.ErrorMessage" /> property to the control ID, which is enclosed in brackets ([]) and sets the <see cref="P:System.Web.UI.WebControls.BaseValidator.Display" /> property to the <see cref="F:System.Web.UI.WebControls.ValidatorDisplay.Static" /> field. The <see cref="M:System.Web.UI.Design.WebControls.BaseValidatorDesigner.GetDesignTimeHtml" /> then calls the <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" /> base method to generate the markup, and restores the control properties to their original values, if necessary.</para> @@ -58,6 +57,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup that is used to render the associated control at design time. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string containing the markup used to render the <see cref="T:System.Web.UI.WebControls.BaseValidator" /> at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml index 701a505f847..53952372285 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml @@ -48,7 +48,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.ButtonDesigner.GetDesignTimeHtml" /> method replaces the <see cref="P:System.Web.UI.WebControls.Button.Text" /> property with the <see cref="P:System.Web.UI.Control.ID" /> property of the <see cref="T:System.Web.UI.WebControls.Button" /> control if the <see cref="P:System.Web.UI.WebControls.Button.Text" /> contains no displayable characters. Then, the <see cref="M:System.Web.UI.Design.WebControls.ButtonDesigner.GetDesignTimeHtml" /> method calls its base method, <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" />, which calls into the <see cref="M:System.Web.UI.Control.RenderControl(System.Web.UI.HtmlTextWriter)" /> method to generate the markup.</para> @@ -57,6 +56,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup that is used to render the associated control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.String" /> containing the markup used to render the <see cref="T:System.Web.UI.WebControls.Button" /> at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml index d52d9ba748f..f21b4f0bf70 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml @@ -45,7 +45,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <see cref="P:System.Web.UI.WebControls.Button.Text" /> property is empty or consists only of white space, then the generated HTML contains the <see cref="P:System.Web.UI.Control.ID" /> of the check box control; otherwise, the generated HTML contains the contents of the control's <see cref="P:System.Web.UI.WebControls.Button.Text" /> property.</para> @@ -55,6 +54,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup that is used to represent the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup that is used to represent the control at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml index e082de7cf76..ac83372f4c9 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml @@ -71,12 +71,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Disconnects events from the previous data source and connects them to the current data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the data-bound control connected to a new data source; false if the data source did not change.</para> + </returns> </Docs> </Member> <Member MemberName="CreateDataSource"> @@ -227,12 +230,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the design-time data source from either the associated DataSourceDesigner or the DataSource property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that implements an <see cref="T:System.Collections.IEnumerable" /> interface referencing the design-time data source.</para> + </returns> </Docs> </Member> <Member MemberName="GetSampleDataSource"> @@ -246,12 +252,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets dummy sample data to render the data-bound control on the design surface if sample data cannot be created from the DataSourceDesigner or DataSource properties.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that implements the <see cref="T:System.Collections.IEnumerable" /> interface containing dummy sample data used to render the data-bound control on the design surface.</para> + </returns> </Docs> </Member> <Member MemberName="PreFilterProperties"> @@ -375,7 +384,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.WebControls.DataBoundControlDesigner" /> instance is cast to an <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> interface.</para> @@ -384,6 +392,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Web.UI.Design.IDataSourceProvider.GetResolvedSelectedDataSource" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The selected data member from the selected data source, if the control allows the user to select an IListSource object (such as a <see cref="T:System.Data.DataSet" /> object) for the data source, and provides a <see cref="P:System.Web.UI.WebControls.DataBoundControl.DataMember" /> property to select a particular list (or <see cref="T:System.Data.DataTable" /> object) within the data source.</para> + </returns> </Docs> </Member> <Member MemberName="System.Web.UI.Design.IDataSourceProvider.GetSelectedDataSource"> @@ -397,7 +409,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.WebControls.DataBoundControlDesigner" /> instance is cast to an <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> interface.</para> @@ -406,6 +417,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Web.UI.Design.IDataSourceProvider.GetSelectedDataSource" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing an <see cref="T:System.Collections.IEnumerable" /> interface containing the design-time <see cref="P:System.Web.UI.WebControls.BaseDataBoundControl.DataSource" /> property of the associated control, or null if a data source is not found.</para> + </returns> </Docs> </Member> <Member MemberName="UseDataSourcePickerActionList"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml index b7fc6450ce0..e857e38b070 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml @@ -88,12 +88,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array of <see cref="T:System.Type" /> objects corresponding to the pages that can be edited using this editor.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Type" /> objects corresponding to the pages that can be edited using this editor.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml index 20ba179710b..a141c73f81e 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml @@ -52,7 +52,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -63,6 +62,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a list of the available ActiveX® Data Objects (ADO) for the .NET Framework (ADO.NET) provider names.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing the names of the available ADO.NET providers.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about a context to a type converter so that the type converter can perform a conversion.</param> </Docs> @@ -80,7 +83,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -91,6 +93,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the returned ActiveX® Data Objects (ADO) for the .NET Framework (ADO.NET) provider names are an exclusive list of possible values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Always false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about a context to a type converter so that the type converter can perform a conversion.</param> </Docs> @@ -108,7 +114,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -118,6 +123,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether this object returns a standard set of ActiveX® Data Objects (ADO) for the .NET Framework (ADO.NET) provider names that can be picked from a list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Always true.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about a context to a type converter so that the type converter can perform a conversion.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml index ef7b3fc64de..5435dd05fa7 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml @@ -50,7 +50,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.HyperLinkDesigner.GetDesignTimeHtml" /> method generates the design-time markup for the associated <see cref="T:System.Web.UI.WebControls.HyperLink" /> control. The method first saves local copies of the <see cref="P:System.Web.UI.WebControls.HyperLink.Text" />, <see cref="P:System.Web.UI.WebControls.HyperLink.NavigateUrl" />, and <see cref="P:System.Web.UI.WebControls.HyperLink.ImageUrl" /> properties, as well as the <see cref="P:System.Web.UI.Control.Controls" /> child collection. It provides default values for these properties if the original values are null or blank. The <see cref="M:System.Web.UI.Design.WebControls.HyperLinkDesigner.GetDesignTimeHtml" /> method then calls the <see cref="M:System.Web.UI.Design.TextControlDesigner.GetDesignTimeHtml" /> base method to generate the markup and restores the properties and child control collection to their original values, if necessary.</para> @@ -59,6 +58,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup that is used to render the associated control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string containing the markup used to render the associated hyperlink control at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml index 2fbc22a475c..e43e81e2a3b 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml @@ -46,12 +46,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the given regular expression object using the given service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this method returns the same object it received.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can provide additional context information.</param> <param name="provider"> @@ -74,12 +77,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editor style used by the <see cref="M:System.Web.UI.Design.WebControls.RegexTypeEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the editor style used by the method.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml index 5b7e5899c72..bc7c8c5a74c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml @@ -113,12 +113,15 @@ </Parameters> <Docs> <param name="minimum_rows">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns design-time sample data based on the <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetResolvedSelectedDataSource" /> method and using the specified number of rows.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.IEnumerable" /> object containing sample data for use at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -138,12 +141,15 @@ <Docs> <param name="selected_data_source">To be added.</param> <param name="minimum_rows">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns design-time sample data based on the provided data and using the specified number of rows.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.IEnumerable" /> object containing sample data for use at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -158,12 +164,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup to be used for the design-time representation of the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Design-time HTML markup.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -222,7 +231,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetResolvedSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetSelectedDataSource" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.Design.WebControls.RepeaterDesigner.DataSource" /> and <see cref="P:System.Web.UI.Design.WebControls.RepeaterDesigner.DataMember" /> properties.</para> @@ -231,6 +239,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the selected data member from the selected data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.IEnumerable" /> that contains a collection of values used to supply design-time data. The default value is null.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -245,7 +257,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.DesignTimeData.GetSelectedDataSource(System.ComponentModel.IComponent,System.String)" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.Design.WebControls.RepeaterDesigner.DataSource" /> property.</para> @@ -254,6 +265,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the selected data source component from the container of the associated <see cref="T:System.Web.UI.WebControls.Repeater" /> control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The selected data source; null if a data source is not found or if a data source with the selected name does not exist.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml index 4797dbb88c2..316e8791896 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml @@ -46,12 +46,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether multiple table cells can be selected at the same time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if multiple cells can be selected at the same time; otherwise, false.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -69,12 +72,15 @@ </Parameters> <Docs> <param name="item_type">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of the editor for use with the specified type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object of the specified type.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml index b2233633c7b..268ae16386e 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml @@ -42,7 +42,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebControls.TableDesigner.GetDesignTimeHtml" /> method ensures that the table has at least one row and cell and that the cells contain some text for display at design time.</para> @@ -51,6 +50,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the HTML that is used to represent the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML used to represent the control at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -65,12 +68,16 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This member overrides <see cref="M:System.Web.UI.Design.ControlDesigner.GetPersistInnerHtml" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The persistable inner HTML markup of the control.</para> + <para /> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml index 04d5d68f0bb..bd9bf55657b 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml @@ -46,12 +46,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether multiple instances may be selected.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if multiple items can be selected at once; otherwise, false. This implementation always returns false.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -69,12 +72,15 @@ </Parameters> <Docs> <param name="item_type">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an instance of the specified type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object of the specified type.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml index 9db23765107..004cbc5d9f2 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml @@ -93,12 +93,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the HTML that is used to fill an empty control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML used to fill an empty control.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml index 3ffce919f0a..bc93a66a666 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml @@ -57,7 +57,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -69,6 +68,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Evaluates an application setting expression string and provides the design-time value for a control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The object referenced by <paramref name="expression" />, if the expression evaluation succeeded; otherwise, null.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />An application setting expression string to evaluate. <paramref name="expression" /> does not include the AppSettings expression prefix.</param> <param name="parseTimeData"> @@ -93,7 +96,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -103,6 +105,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an expression editor sheet for an application setting expression.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.ExpressionEditorSheet" /> implementation that defines the application setting expression properties.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />The expression string set for a control property, used to initialize the expression editor sheet. <paramref name="expression" /> does not include the AppSettings expression prefix.</param> <param name="serviceProvider"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml index b97c3e19414..a063055d847 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml @@ -34,7 +34,6 @@ <Parameter Name="initialColor" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The returned string, if other than null, indicates a color in a valid HTML color format. Valid formats include named colors and color codes in RGB format (#RRGGBB).</para> @@ -43,6 +42,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Starts a color editor to build an HTML color property value.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The color value, represented as a string in an HTML color format, or null if the builder service could not be retrieved.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> whose site is to be used to access design-time services. </param> <param name="owner"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml index 5ddfd0ab619..9b0464755bb 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml @@ -51,7 +51,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.EditValue" /> method starts the user interface for editing the <paramref name="value" /> object. The designer host calls the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.EditValue" /> method when you edit the value of a property that the connection string editor is associated with. The input service provider is used to obtain any editing services that are required within the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.EditValue" /> method.</para> @@ -62,6 +61,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object by using the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The selected connection expression, as a string object; otherwise, if a connection expression was not selected, the same <paramref name="value" /> that was passed in.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> to use to gain additional context information.</param> <param name="provider"> @@ -83,7 +86,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>By default, the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.GetEditStyle" /> method of the <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class returns the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.Modal" /> value. If an <see cref="T:System.ComponentModel.Design.Data.IDataEnvironment" /> service implementation is supported in the specified context, the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.GetEditStyle" /> method returns the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.DropDown" /> value.</para> @@ -93,6 +95,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the editing style that is associated with the connection string editor for the specified context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value that indicates the editing style for the provided user interface.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> to use to gain additional context information.</param> </Docs> @@ -110,7 +116,6 @@ <Parameter Name="instance" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ConnectionStringEditor.GetProviderName(System.Object)" /> method gets the provider name for the current instance of the <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class. For example, in the <see cref="T:System.Web.UI.Design.WebControls.SqlDataSourceConnectionStringEditor" /> class, which is derived from <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class, the <see cref="M:System.Web.UI.Design.ConnectionStringEditor.GetProviderName(System.Object)" /> method returns the provider name.</para> @@ -119,6 +124,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the provider name for the provided instance of the <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Always an empty string ("").</para> + </returns> <param name="instance"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> or an instance of a derived class.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml index b81db4d7c8c..dcb8d2c65ec 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml @@ -51,7 +51,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -63,6 +62,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Evaluates a connection string expression and provides the design-time value for a control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The object referenced by the evaluated expression string if the expression evaluation succeeded; otherwise, null.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />A connection string expression to evaluate. The expression does not include the ConnectionStrings expression prefix.</param> <param name="parseTimeData"> @@ -87,7 +90,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -97,6 +99,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an expression editor sheet for a connection string expression.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.ExpressionEditorSheet" /> instance that defines the connection string expression properties.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />The expression string set for a control property, used to initialize the expression editor sheet. The expression does not include the ConnectionStrings expression prefix.</param> <param name="serviceProvider"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml index 461ea21a2ea..5e703323b08 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml @@ -161,7 +161,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetDesignTimeCssAttributes" /> method returns a collection of style attributes for the design-time representation of the control.</para> @@ -172,6 +171,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the collection of style attributes for the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of style attributes applied to the control on the design surface. The style attribute names are keys used to access the style attribute values in the <see cref="T:System.Collections.IDictionary" />.</para> + </returns> </Docs> </Member> <Member MemberName="GetDesignTimeHtml"> @@ -187,7 +190,6 @@ <Parameter Name="regions" Type="System.Web.UI.Design.DesignerRegionCollection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Use the <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetDesignTimeHtml(System.Web.UI.Design.DesignerRegionCollection)" /> method to get the HTML for the control. Child controls that are contained in the editable design region are rendered using their associated control designers.</para> @@ -197,6 +199,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the HTML markup that is used to represent the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An HTML markup string that represents the control.</para> + </returns> <param name="regions"> <attribution license="cc4" from="Microsoft" modified="false" />A collection of designer regions.</param> </Docs> @@ -214,7 +220,6 @@ <Parameter Name="region" Type="System.Web.UI.Design.EditableDesignerRegion" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.Web.UI.Design.ContainerControlDesigner" /> class implements a single designer region instead of a collection of designer regions. Therefore, the <paramref name="region" /> parameter is ignored, and the <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetEditableDesignerRegionContent(System.Web.UI.Design.EditableDesignerRegion)" /> method returns the content for the single designer region that is contained in the control designer.</para> @@ -223,6 +228,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the content for the editable region of the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The persisted content of the region contained within the <see cref="T:System.Web.UI.Design.ContainerControlDesigner" />.</para> + </returns> <param name="region"> <attribution license="cc4" from="Microsoft" modified="false" />An editable design region contained within the control.</param> </Docs> @@ -238,7 +247,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetPersistenceContent" /> method returns null to indicate that the <see cref="T:System.Web.UI.Design.ContainerControlDesigner" /> class does not have persisted inner content.</para> @@ -247,6 +255,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the persistable content of the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>null.</para> + </returns> </Docs> </Member> <Member MemberName="SetEditableDesignerRegionContent"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml index bdb262513db..1a039867fc2 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml @@ -222,7 +222,6 @@ <Parameter Name="errorMessage" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Use the <see cref="M:System.Web.UI.Design.ControlDesigner.CreateErrorDesignTimeHtml(System.String)" /> method to create HTML markup to display an error message for a control at design time. The value for <paramref name="errorMessage" /> specifies a localized string that is displayed to the user of the control at design time.</para> @@ -241,6 +240,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates HTML markup to display a specified error message at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An HTML markup string that contains the specified error message.</para> + </returns> <param name="errorMessage"> <attribution license="cc4" from="Microsoft" modified="false" />The error message to include in the generated HTML markup.</param> </Docs> @@ -259,7 +262,6 @@ <Parameter Name="e" Type="System.Exception" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Use the <see cref="M:System.Web.UI.Design.ControlDesigner.CreateErrorDesignTimeHtml(System.String,System.Exception)" /> method to provide simple HTML markup that can be used to display error and exception details for a control at design time. The value for <paramref name="errorMessage" /> specifies a localized string that is displayed to the user of the control at design time.</para> @@ -278,6 +280,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates the HTML markup to display a specified exception error message at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>HTML markup that contains the specified <paramref name="errorMessage" /> and <paramref name="e" />.</para> + </returns> <param name="errorMessage"> <attribution license="cc4" from="Microsoft" modified="false" />The error message to include in the generated HTML string.</param> <param name="e"> @@ -292,12 +298,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides a simple rectangular placeholder representation that displays the type and ID of the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that contains design-time HTML markup providing basic information about the control.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -314,12 +323,15 @@ <Parameter Name="instruction" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides a simple rectangular placeholder representation that displays the type and ID of the control, and also additional specified instructions or information.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that contains design-time HTML markup providing information about the control.</para> + </returns> <param name="instruction"> <attribution license="cc4" from="Microsoft" modified="false" />A string that contains text and markup to add to the HTML output. </param> </Docs> @@ -339,12 +351,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a copy of the associated control for viewing or rendering on the design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A Web server control.</para> + </returns> </Docs> </Member> <Member MemberName="DataBindingsEnabled"> @@ -457,12 +472,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the coordinates of the rectangle representing the boundaries for the control as displayed on the design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Rectangle" /> object representing the boundaries for the control on the design surface relative to the control, not the document.</para> + </returns> </Docs> </Member> <Member MemberName="GetDesignTimeHtml"> @@ -473,12 +491,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup that is used to represent the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML markup used to represent the control at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -498,7 +519,6 @@ <Parameter Name="regions" Type="System.Web.UI.Design.DesignerRegionCollection" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The design host calls the <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml(System.Web.UI.Design.DesignerRegionCollection)" /> method to get the design-time HTML markup and the current list of control designer regions. Using the DesignerRegionCollection, the design host can then request the markup for each editable control designer region.</para> @@ -508,6 +528,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup to display the control and populates the collection with the current control designer regions.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The design-time HTML markup for the associated control, including all control designer regions.</para> + </returns> <param name="regions"> <attribution license="cc4" from="Microsoft" modified="false" />A collection of control designer regions for the associated control.</param> </Docs> @@ -525,7 +549,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A resource provider factory creates resource providers and resource writers, depending on the current settings in the system.web/globalization section of the configuration file (either the Machine.config or Web.config files for both global and local resources). If no globalization settings are found, the <paramref name="serviceProvider" /> parameter is used to create a <see cref="T:System.Web.UI.Design.DesignTimeResourceProviderFactory" /> object using the default implementation for the design host.</para> @@ -535,6 +558,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an appropriate resource provider factory, depending on the globalization settings in the configuration file for the site.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.DesignTimeResourceProviderFactory" /> object, if any are defined in the configuration file; otherwise, null.</para> + </returns> <param name="serviceProvider"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IServiceProvider" /> object that can retrieve global and local services.</param> </Docs> @@ -552,7 +579,6 @@ <Parameter Name="region" Type="System.Web.UI.Design.EditableDesignerRegion" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation of the <see cref="M:System.Web.UI.Design.ControlDesigner.GetEditableDesignerRegionContent(System.Web.UI.Design.EditableDesignerRegion)" /> method returns an empty string (""). </para> @@ -562,6 +588,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the content for an editable region of the design-time view of the associated control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The persisted content for the region, if the control designer supports editable regions; otherwise, an empty string ("").</para> + </returns> <param name="region"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.EditableDesignerRegion" /> object to get content for.</param> </Docs> @@ -574,7 +604,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default behavior of the <see cref="M:System.Web.UI.Design.ControlDesigner.GetEmptyDesignTimeHtml" /> method is to return a string that contains the name of the component. The <see cref="M:System.Web.UI.Design.ControlDesigner.GetEmptyDesignTimeHtml" /> method should be called in the implementation of the <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" /> method when there is no design-time HTML markup.</para> @@ -583,6 +612,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup to represent a Web server control at design time that will have no visual representation at run time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML markup used to represent a control at design time that would otherwise have no visual representation. The default is a rectangle that contains the type and ID of the component.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -599,7 +632,6 @@ <Parameter Name="e" Type="System.Exception" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlDesigner.GetErrorDesignTimeHtml(System.Exception)" /> method is typically called, if an exception is thrown in the <see cref="Overload:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" /> method.</para> @@ -608,6 +640,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup that provides information about the specified exception. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The design-time HTML markup for the specified exception.</para> + </returns> <param name="e"> <attribution license="cc4" from="Microsoft" modified="false" />The exception that occurred. </param> </Docs> @@ -627,12 +663,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the persistable inner HTML markup of the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string representing the persistable inner HTML markup for the associated control. The default is null.</para> + </returns> </Docs> </Member> <Member MemberName="GetPersistInnerHtml"> @@ -643,7 +682,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -654,6 +692,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the persistable inner HTML markup of the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The persistable inner HTML markup of the control.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -676,12 +718,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves an object that contains the design-time markup for the content and regions of the associated control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para> + </returns> </Docs> </Member> <Member MemberName="GetViewRendering"> @@ -697,12 +742,15 @@ <Parameter Name="control" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves an object that contains the design-time markup for the content and regions of the specified control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Control" /> object.</param> </Docs> @@ -720,12 +768,15 @@ <Parameter Name="designer" Type="System.Web.UI.Design.ControlDesigner" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves an object that contains the design-time markup for the content and regions of the associated control for the specified control designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para> + </returns> <param name="designer"> <attribution license="cc4" from="Microsoft" modified="false" />A control designer that derives from <see cref="T:System.Web.UI.Design.ControlDesigner" />.</param> </Docs> @@ -1033,7 +1084,6 @@ <Parameter Name="propName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -1044,6 +1094,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves a value indicating whether the specified property on the associated control is data-bound.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the property is data-bound; otherwise, false.</para> + </returns> <param name="propName"> <attribution license="cc4" from="Microsoft" modified="false" />The property to test for data binding. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml index 5080b162ac8..72db6f56e56 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml @@ -32,7 +32,6 @@ <Parameter Name="controlText" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseControl(System.ComponentModel.Design.IDesignerHost,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para> @@ -42,6 +41,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a control from the specified markup using the specified designer host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Web.UI.Control" /> that controlText represents; otherwise, null, if the parser cannot build the control.</para> + </returns> <param name="designerHost"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page. </param> <param name="controlText"> @@ -64,7 +67,6 @@ <Parameter Name="directives" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseControl(System.ComponentModel.Design.IDesignerHost,System.String,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para> @@ -74,6 +76,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a control from the specified markup using the specified designer host and directives.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Web.UI.Control" /> that <paramref name="controlText" /> represents.</para> + </returns> <param name="designerHost"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page.</param> <param name="controlText"> @@ -100,7 +106,6 @@ <Parameter Name="controlText" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseControls(System.ComponentModel.Design.IDesignerHost,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para> @@ -110,6 +115,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an array of controls from the specified markup using the specified designer host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Control" /> elements, parsed from <paramref name="controlText" />; otherwise, null, if the parser cannot build the controls.</para> + </returns> <param name="designerHost"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page.</param> <param name="controlText"> @@ -127,7 +136,6 @@ <Parameter Name="templateText" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseTemplate(System.ComponentModel.Design.IDesignerHost,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para> @@ -136,6 +144,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates an <see cref="T:System.Web.UI.ITemplate" /> interface from the specified template markup.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.ITemplate" /> instance created by parsing <paramref name="templateText" />.</para> + </returns> <param name="designerHost"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page. </param> <param name="templateText"> @@ -158,7 +170,6 @@ <Parameter Name="directives" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseTemplate(System.ComponentModel.Design.IDesignerHost,System.String,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para> @@ -167,6 +178,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Parses the specified template markup and creates an <see cref="T:System.Web.UI.ITemplate" /> interface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.ITemplate" /> instance created by parsing <paramref name="templateText" />.</para> + </returns> <param name="designerHost"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page. </param> <param name="templateText"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml index a29f8690c8f..dcbd7e1d163 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml @@ -35,7 +35,6 @@ <Parameter Name="control" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation to work correctly. This method uses the <see cref="P:System.Web.UI.Control.Site" /> of the specified control to retrieve the designer host.</para> @@ -44,6 +43,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a string of data that represents the persisted form of the specified control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that represents the persisted form of the control.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> to persist. </param> </Docs> @@ -92,7 +95,6 @@ <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation to work correctly.</para> @@ -101,6 +103,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a string of data that represents the persisted form of the specified control, using the specified designer host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that represents the persisted form of the control.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> to persist. </param> <param name="host"> @@ -154,7 +160,6 @@ <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation to work correctly.</para> @@ -163,6 +168,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a string of data that can persist the inner properties of the specified control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that contains the information to persist about the inner properties of the control.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to persist the inner properties of. </param> <param name="host"> @@ -219,7 +228,6 @@ <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.ControlPersister.PersistTemplate(System.Web.UI.ITemplate,System.ComponentModel.Design.IDesignerHost)" /> method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> interface implementation in order to work correctly.</para> @@ -228,6 +236,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a string of data that represents the persisted form of the specified template.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that represents the persisted form of the template.</para> + </returns> <param name="template"> <attribution license="cc4" from="Microsoft" modified="false" />The template to persist.</param> <param name="host"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml index 5e13787071f..5996bd4e240 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml @@ -50,7 +50,6 @@ <Parameter Name="destinationType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method returns an empty string if the <paramref name="destinationType" /> parameter is of type <see cref="T:System.String" />. Otherwise this method calls the <see cref="M:System.ComponentModel.TypeConverter.ConvertTo(System.Object,System.Type)" /> method of the base <see cref="T:System.ComponentModel.TypeConverter" /> class.</para> @@ -59,6 +58,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts a data binding collection to the specified type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The object produced by the type conversion. If the <paramref name="destinationType" /> parameter is of type <see cref="T:System.String" />, this method returns an empty string ("").</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that indicates the component or control to which the data binding collection belongs. </param> <param name="culture"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml index 0ca26fc908c..cbc92ca2eb6 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml @@ -49,12 +49,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified data-binding collection using the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new collection.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that identifies the component or control the collection belongs to. </param> <param name="provider"> @@ -77,7 +80,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This editor provides a modal editor style.</para> @@ -86,6 +88,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editor style used by the <see cref="M:System.Web.UI.Design.DataBindingCollectionEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> object that specifies the editor style of the component or control.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that identifies the component or control to retrieve the edit style for. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml index d170e7828f6..4e209b79334 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml @@ -60,7 +60,6 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Call the <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method to determine whether the <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method supports converting the source type.</para> @@ -70,6 +69,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the specified source type can be converted to the type of the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the converter can perform the conversion; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> <param name="sourceType"> @@ -91,7 +94,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If <paramref name="value" /> is a string, then the string representation of <paramref name="value" /> is returned. If <paramref name="value" /> is null, an empty string ("") is returned. For all other values, a <see cref="T:System.NotSupportedException" /> exception is thrown. </para> @@ -101,6 +103,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified object to the type of the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> instance that represents the converted object.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> <param name="culture"> @@ -122,7 +128,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="P:System.ComponentModel.ITypeDescriptorContext.Instance" /> property of the specified <paramref name="context" /> object to obtain an <see cref="T:System.ComponentModel.IComponent" /> implementation. If the <see cref="T:System.ComponentModel.IComponent" /> implementation is available, it is used to access the associated control at design time and retrieve the list of available values from the associated <see cref="T:System.Web.UI.WebControls.GridView" /> component.</para> @@ -132,6 +137,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a list of available values that can be assigned to the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> instance containing available values for assignment to the associated control property.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> </Docs> @@ -149,7 +158,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValuesExclusive" /> method for a <see cref="T:System.Web.UI.Design.DataColumnSelectionConverter" /> instance returns false, indicating that the list returned by the <see cref="Overload:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValues" /> method is not an exclusive list of all possible assignable values.</para> @@ -158,6 +166,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this converter returns a list containing all possible values that can be assigned to the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if this converter returns a list containing all possible values that can be assigned to the associated control property; otherwise false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> </Docs> @@ -175,7 +187,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method indicates whether the converter supports returning a list of available values through the <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method. </para> @@ -185,6 +196,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this converter returns a set of available values for assignment to a control property, within the specified context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if this converter returns a standard set of available values for assignment to the associated control property; otherwise false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml index 52a6270bfce..24fb89bb57a 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml @@ -54,7 +54,6 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method returns true if the source type is a string. Otherwise, this method always returns false.</para> @@ -63,6 +62,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the converter can convert an object of the specified source type to the native type of the converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the converter can perform the conversion; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> <param name="sourceType"> @@ -85,12 +88,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified object to the native type of the converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> that represents the specified object after conversion.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> <param name="culture"> @@ -113,7 +119,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method uses the <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> implementation on the component's designer to retrieve the selected data source.</para> @@ -122,6 +127,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data fields present within the selected data source if information about them is available.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> listing the standard accessible data sources.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object indicating the component or control to get values for. </param> </Docs> @@ -140,7 +149,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the list is exclusive, such as in an enumeration data type, then no other values are valid. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> provides.</para> @@ -149,6 +157,11 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is a list of all possible values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of all possible values that are valid; false if other values are possible.</para> + <para>As implemented in this class, this method always returns false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> </Docs> @@ -167,12 +180,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the converter supports a standard set of values that can be picked from a list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> can be called to find a common set of values the object supports; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml index 44f1afa06e2..cfe0750e98a 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml @@ -54,12 +54,15 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the converter can convert an object of the specified source type to the native type of the converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the converter can perform the conversion; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> <param name="sourceType"> @@ -82,12 +85,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified object to the native type of the converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> that represents the specified object after conversion.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> <param name="culture"> @@ -110,7 +116,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The converter uses the <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> implementation of the associated component's designer to retrieve the current data source selection.</para> @@ -119,6 +124,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data members present within the selected data source, if information about them is available.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> listing the data members of the data source selected for the component. </para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object indicating the component or control to get values for. </param> </Docs> @@ -137,7 +146,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the list is exclusive, such as in an enumeration data type, then no other values are valid. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> provides.</para> @@ -146,6 +154,11 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is a list of all possible values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of all possible values that are valid; false if other values are possible.</para> + <para>As implemented in this class, this method always returns false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context. </param> </Docs> @@ -164,12 +177,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the converter supports a standard set of values that can be picked from a list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false. This implementation always returns true.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml index c3c2136c7a8..30df011e5ba 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml @@ -73,7 +73,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Each of the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects returned by this method can be converted to a <see cref="T:System.Web.UI.Design.DataSetViewSchema" /> object.</para> @@ -82,6 +81,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array containing information about each view in the data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml index d707bb6404c..750e2103aa1 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml @@ -73,7 +73,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSetViewSchema.GetChildren" /> method inherited from <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> is not implemented in this class and always returns null.</para> @@ -82,6 +81,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array representing the child views contained in the current view.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>null.</para> + </returns> </Docs> </Member> <Member MemberName="GetFields"> @@ -95,7 +98,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSetViewSchema.GetFields" /> method does not return information about hidden fields.</para> @@ -104,6 +106,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array containing information about each data field in the view.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceFieldSchema" /> objects.</para> + </returns> </Docs> </Member> <Member MemberName="Name"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml index 24a1301b6c9..130396fbc24 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml @@ -45,12 +45,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a list of available Boolean values that can be assigned to the associated field.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of Boolean values.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml index 5cd57eaf8b0..c98dca8d93c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml @@ -54,12 +54,16 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the converter can convert an object of the specified source type to the native type of the converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the converter can perform the conversion; otherwise, false.</para> + <para>As implemented in this class, this method always returns false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="sourceType"> @@ -82,12 +86,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified object to the native type of the converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> that represents the specified object after conversion.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="culture"> @@ -110,7 +117,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The data sources that are accessible to the component are determined by retrieving a list of components from the designer, testing each component with the <see cref="M:System.Web.UI.Design.DataSourceConverter.IsValidDataSource(System.ComponentModel.IComponent)" /> method, and then returning the components that are valid data sources.</para> @@ -119,6 +125,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the standard data sources accessible to the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> listing the standard accessible data sources.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> indicating the component or control to get values for. </param> </Docs> @@ -137,7 +147,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the list is exclusive, such as in an enumeration data type, then no other values are valid. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> provides.</para> @@ -146,6 +155,11 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is a list of all possible values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of all possible values; false if other values are possible.</para> + <para>As implemented in this class, this method always returns false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> @@ -164,12 +178,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the converter supports a standard set of values that can be picked from a list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false. This implementation always returns true.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> @@ -191,7 +208,6 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSourceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="M:System.Web.UI.Design.DataSourceConverter.IsValidDataSource(System.ComponentModel.IComponent)" /> method to determine the components that are available as standard accessible data sources. For the <see cref="T:System.Web.UI.Design.DataSourceConverter" /> class, a valid data source is a component that implements the <see cref="T:System.Collections.IEnumerable" /> or <see cref="T:System.ComponentModel.IListSource" /> interface. </para> @@ -200,6 +216,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the specified component is a valid data source for this converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="component" /> implements <see cref="T:System.Collections.IEnumerable" /> or <see cref="T:System.ComponentModel.IListSource" />; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to check as a valid data source.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml index 5a1132573f3..be25a687c69 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml @@ -187,7 +187,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation of the <see cref="M:System.Web.UI.Design.DataSourceDesigner.GetDesignTimeHtml" /> method returns the result from the base <see cref="M:System.Web.UI.Design.ControlDesigner.CreatePlaceHolderDesignTimeHtml" /> method.</para> @@ -196,6 +195,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup for displaying the associated data source control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup for the design-time display.</para> + </returns> </Docs> </Member> <Member MemberName="GetView"> @@ -211,7 +214,6 @@ <Parameter Name="viewName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>In derived classes, if <paramref name="viewName" /> does not exist, the <see cref="M:System.Web.UI.Design.DataSourceDesigner.GetView(System.String)" /> method should return null.</para> @@ -220,6 +222,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves a <see cref="T:System.Web.UI.Design.DesignerDataSourceView" /> object that is identified by the view name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>This implementation always returns null.</para> + </returns> <param name="viewName"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the view.</param> </Docs> @@ -235,12 +241,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an array of the view names that are available in this data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of view names.</para> + </returns> </Docs> </Member> <Member MemberName="OnDataSourceChanged"> @@ -370,7 +379,6 @@ <Parameter Name="schema2" Type="System.Web.UI.Design.IDataSourceSchema" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Comparison of the two schemas is based on the views, as well as the names and types of the fields that are contained in the views. The <see cref="M:System.Web.UI.Design.DataSourceDesigner.SchemasEquivalent(System.Web.UI.Design.IDataSourceSchema,System.Web.UI.Design.IDataSourceSchema)" /> method can be used without an instance of the <see cref="T:System.Web.UI.Design.DataSourceDesigner" /> class.</para> @@ -379,6 +387,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides a value that indicates whether two schemas are equal.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if both schemas are equivalent; otherwise, false.</para> + </returns> <param name="schema1"> <attribution license="cc4" from="Microsoft" modified="false" />The first schema to compare (derived from the <see cref="T:System.Web.UI.Design.IDataSourceSchema" />).</param> <param name="schema2"> @@ -438,7 +450,6 @@ <Parameter Name="viewSchema2" Type="System.Web.UI.Design.IDataSourceViewSchema" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSourceDesigner.ViewSchemasEquivalent(System.Web.UI.Design.IDataSourceViewSchema,System.Web.UI.Design.IDataSourceViewSchema)" /> method can be used without an instance of the <see cref="T:System.Web.UI.Design.DataSourceDesigner" /> class.</para> @@ -447,6 +458,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides a value that determines whether two schema views are equal.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if both views are equivalent; otherwise, false. </para> + </returns> <param name="viewSchema1"> <attribution license="cc4" from="Microsoft" modified="false" />The first view to compare (derived from the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" />).</param> <param name="viewSchema2"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml index 2bbed2230e7..f73080afb55 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml @@ -60,7 +60,6 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Call the <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method to determine whether the <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method supports converting the source type.</para> @@ -70,6 +69,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the specified source type can be converted to the type of the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the converter can perform the conversion; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> <param name="sourceType"> @@ -91,7 +94,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If <paramref name="value" /> is a string, then the string representation of <paramref name="value" /> is returned. If <paramref name="value" /> is null, an empty string ("") is returned. For all other specified values, a <see cref="T:System.NotSupportedException" /> exception is thrown. </para> @@ -101,6 +103,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified object to the type of the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> instance that represents the converted object.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> <param name="culture"> @@ -122,7 +128,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="P:System.ComponentModel.ITypeDescriptorContext.Instance" /> property of the specified <paramref name="context" /> object to obtain an <see cref="T:System.Web.UI.IDataSourceViewSchemaAccessor" /> implementation. If the <see cref="T:System.Web.UI.IDataSourceViewSchemaAccessor" /> implementation is available, it is used to access the data source schema for the associated control at design time and retrieve the list of available fields from the associated data source schema view.</para> @@ -132,6 +137,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a list of available values that can be assigned to the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing available values for assignment to the associated control property.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> </Docs> @@ -150,12 +159,15 @@ <Parameter Name="typeFilter" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a list of available values that can be assigned to the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing available values for assignment to the associated control property.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> <param name="typeFilter"> @@ -175,7 +187,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValuesExclusive" /> method for a <see cref="T:System.Web.UI.Design.DataSourceViewSchemaConverter" /> returns false, indicating that the list returned by the <see cref="Overload:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValues" /> method is not an exclusive list of all possible assignable values.</para> @@ -184,6 +195,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this converter returns a list containing all possible values that can be assigned to the associated control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if this converter returns a list containing all possible values that can be assigned to the associated control property; otherwise false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> </Docs> @@ -201,7 +216,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method indicates whether the converter supports returning a list of available values through the <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method.</para> @@ -211,6 +225,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether this converter returns a set of available values for assignment to a control property within the specified context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if this converter returns a standard set of available values for assignment to the associated control property; otherwise false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml index c881813d4f3..01e30855f4d 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml @@ -29,7 +29,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The table is not actually bound to a data source. Each column name simply indicates that it is a data-bound column. The column data types are string, integer, and string. The calling designer component must add rows and data to the resulting table.</para> @@ -38,6 +37,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a <see cref="T:System.Data.DataTable" /> object that contains three columns with names indicating that the columns are connected to a data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new <see cref="T:System.Data.DataTable" /> object with three columns and no data.</para> + </returns> </Docs> </Member> <Member MemberName="CreateDummyDataTable"> @@ -48,7 +51,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The column data types are all string. The calling designer component can call the <see cref="M:System.Web.UI.Design.DesignTimeData.GetDesignTimeDataSource(System.Data.DataTable,System.Int32)" /> method to add rows of data to the resulting table.</para> @@ -57,6 +59,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a <see cref="T:System.Data.DataTable" /> object that contains three columns with names that indicate that the columns contain sample data.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A new <see cref="T:System.Data.DataTable" /> with three columns. These columns can contain data of type string.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -73,7 +79,6 @@ <Parameter Name="referenceData" Type="System.Collections.IEnumerable" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The data types that can be created are the primitive types, such as number, string, and date types. Any other types are replaced by columns of type String. The calling designer component can call the <see cref="M:System.Web.UI.Design.DesignTimeData.GetDesignTimeDataSource(System.Data.DataTable,System.Int32)" /> method to add rows of data to the resulting table.</para> @@ -82,6 +87,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a sample <see cref="T:System.Data.DataTable" /> object with the same schema as the provided data.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Data.DataTable" /> object that contains columns with the same names and data types as the provided <paramref name="referenceData" />.</para> + </returns> <param name="referenceData"> <attribution license="cc4" from="Microsoft" modified="false" />A data source with the desired schema to use as the format for the sample <see cref="T:System.Data.DataTable" /> object. </param> </Docs> @@ -104,7 +113,6 @@ <Parameter Name="useDataBoundData" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The data types that can be created are the primitive types, such as number, string, and date types. Any other types are replaced by columns of type String. The calling designer component can use <see cref="M:System.Web.UI.Design.DesignTimeData.GetDesignTimeDataSource(System.Data.DataTable,System.Int32)" /> to add rows of data to the resulting table.</para> @@ -113,6 +121,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a <see cref="T:System.Data.DataTable" /> object with the same schema as the provided data and optionally containing column names indicating that the data is bound data.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Data.DataTable" /> object.</para> + </returns> <param name="referenceData"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IEnumerable" /> object containing data.</param> <param name="useDataBoundData"> @@ -147,12 +159,15 @@ <Parameter Name="dataSource" Type="System.Collections.IEnumerable" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a collection of property descriptors for the data fields of the specified data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> object that describes the data fields of the specified data source.</para> + </returns> <param name="dataSource"> <attribution license="cc4" from="Microsoft" modified="false" />The data source from which to retrieve the data fields. </param> </Docs> @@ -172,7 +187,6 @@ <Parameter Name="dataMember" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method searches the specified data source for the specified data member. If <paramref name="dataMember" /> is null, the first data member in the specified data source is returned.</para> @@ -181,6 +195,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the specified data member from the specified data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> containing the specified data member from the specified data source, if it exists.</para> + </returns> <param name="dataSource"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.IListSource" /> that contains the data in which to find the member. </param> <param name="dataMember"> @@ -201,12 +219,15 @@ <Parameter Name="dataSource" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the names of the data members in the specified data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of type String that contains the names of the data members in the specified data source.</para> + </returns> <param name="dataSource"> <attribution license="cc4" from="Microsoft" modified="false" />The data source from which to retrieve the names of the members. </param> </Docs> @@ -226,12 +247,15 @@ <Parameter Name="minimumRows" Type="System.Int32" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds the specified number of sample rows to the specified data table.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> containing sample data for use at design time.</para> + </returns> <param name="dataTable"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> object to which the sample rows are added. </param> <param name="minimumRows"> @@ -253,12 +277,15 @@ <Parameter Name="dataSource" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a data source selected by name in the design host, represented by the specified component's site property and identified by the specified data source name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing either <see cref="T:System.ComponentModel.IListSource" /> or <see cref="T:System.Collections.IEnumerable" /> representing the selected data source, or null if the data source or the designer host could not be accessed.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> object that contains the data source. </param> <param name="dataSource"> @@ -281,12 +308,15 @@ <Parameter Name="dataMember" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a data source selected by name in the design host, represented by the specified component's site property and identified by the specified data-source name and member name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> containing the data member, or null if the data source, member, or component's site could not be accessed.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The object implementing <see cref="T:System.ComponentModel.IComponent" /> that contains the data sourced property. </param> <param name="dataSource"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml index 31d2123cd48..b24d573e302 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml @@ -46,12 +46,15 @@ <Parameter Name="classKey" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, creates a global resource provider using the provided <see cref="T:System.IServiceProvider" /> interface and resource class name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>Either an <see cref="T:System.Web.Compilation.IResourceProvider" /> or an <see cref="T:System.Web.UI.Design.IDesignTimeResourceWriter" />.</para> + </returns> <param name="serviceProvider"> <attribution license="cc4" from="Microsoft" modified="false" />A reference to the design host.</param> <param name="classKey"> @@ -71,12 +74,15 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, creates a local resource provider using the provided reference to the design host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.Compilation.IResourceProvider" /> or a class derived from <see cref="T:System.Web.Compilation.IResourceProvider" />.</para> + </returns> <param name="serviceProvider"> <attribution license="cc4" from="Microsoft" modified="false" />A reference to the design host.</param> </Docs> @@ -94,12 +100,15 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, creates a local resource writer for using the provided reference to the design host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A local resource writer for using the provided reference to the design host.</para> + </returns> <param name="serviceProvider"> <attribution license="cc4" from="Microsoft" modified="false" />A reference to the design host.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml index 27aa4b0da9c..c20801b68fe 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml @@ -109,7 +109,6 @@ <Parameter Name="runtimeControl" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormat.GetPreviewControl(System.Web.UI.Control)" /> method is used by visual designers, such as vsprvslong, in an <ui>AutoFormat</ui> dialog box to display a formatted run-time preview of the control at design time before applying the format to the actual control.</para> @@ -119,6 +118,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a copy of the associated control in order to provide a preview before applying the format to the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormat.GetPreviewControl(System.Web.UI.Control)" /> method returns a copy of the associated Web server control.</para> + </returns> <param name="runtimeControl"> <attribution license="cc4" from="Microsoft" modified="false" />A run-time version of the Web server control.</param> </Docs> @@ -176,7 +179,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormat.ToString" /> method returns a string that contains the value of the <see cref="P:System.Web.UI.Design.DesignerAutoFormat.Name" /> property of the <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object.</para> @@ -185,6 +187,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a string that represents the current <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="P:System.Web.UI.Design.DesignerAutoFormat.Name" /> property of the current <see cref="T:System.Web.UI.Design.DesignerAutoFormat" />.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml index da7bc87de49..c6f7d6ce9ac 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml @@ -89,7 +89,6 @@ <Parameter Name="format" Type="System.Web.UI.Design.DesignerAutoFormat" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.Add(System.Web.UI.Design.DesignerAutoFormat)" /> method adds the specified <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object to the end of the collection. To add a <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object to the collection at a specific index location, use the <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.Insert(System.Int32,System.Web.UI.Design.DesignerAutoFormat)" /> method.</para> @@ -98,6 +97,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds the specified <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object to the end of the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which the format was added to the collection.</para> + </returns> <param name="format"> <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Web.UI.Design.DesignerAutoFormat" />.</param> </Docs> @@ -136,7 +139,6 @@ <Parameter Name="format" Type="System.Web.UI.Design.DesignerAutoFormat" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.Contains(System.Web.UI.Design.DesignerAutoFormat)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> objects that are being compared.</para> @@ -145,6 +147,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the specified format is contained within the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the specified format is in the collection; otherwise, false.</para> + </returns> <param name="format"> <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Web.UI.Design.DesignerAutoFormat" />.</param> </Docs> @@ -183,7 +189,6 @@ <Parameter Name="format" Type="System.Web.UI.Design.DesignerAutoFormat" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.IndexOf(System.Web.UI.Design.DesignerAutoFormat)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> objects that are being compared.</para> @@ -192,6 +197,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of the specified <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object within the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The zero-based index of the first occurrence of <paramref name="format" /> within the collection; otherwise, -1, if the format is not in the collection.</para> + </returns> <param name="format"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> to locate within the collection.</param> </Docs> @@ -429,7 +438,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para> @@ -438,6 +446,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an <see cref="T:System.Collections.IEnumerator" /> interface that iterates through the collection when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" />.</para> + </returns> </Docs> </Member> <Member MemberName="System.Collections.IList.Add"> @@ -454,7 +466,6 @@ </Parameters> <Docs> <param name="item">To be added.</param> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -463,6 +474,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds an item to the collection when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the added item.</para> + </returns> </Docs> </Member> <Member MemberName="System.Collections.IList.Contains"> @@ -479,7 +494,6 @@ </Parameters> <Docs> <param name="item">To be added.</param> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -488,6 +502,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the collection contains a specific value when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the object is in the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" />; otherwise, false.</para> + </returns> </Docs> </Member> <Member MemberName="System.Collections.IList.IndexOf"> @@ -504,7 +522,6 @@ </Parameters> <Docs> <param name="item">To be added.</param> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerAutoFormatCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -513,6 +530,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines the index of a specific item in the collection when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of a item in the collection.</para> + </returns> </Docs> </Member> <Member MemberName="System.Collections.IList.Insert"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml index aeb75bf625f..2f6a121008d 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml @@ -74,12 +74,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a service from the design host, as identified by the provided type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service being requested.</param> </Docs> @@ -133,12 +136,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.IServiceProvider.GetService(System.Type)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service being requested.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml index 05b821e19c3..182450622cb 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml @@ -383,7 +383,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerRegion.GetBounds" /> method returns a value that is equivalent to calling the <see cref="M:System.Web.UI.Design.IControlDesignerView.GetBounds(System.Web.UI.Design.DesignerRegion)" /> method on the <see cref="P:System.Web.UI.Design.DesignerObject.Designer" /> object with this designer region.</para> @@ -392,6 +391,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the size of the designer region on the design surface.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Rectangle" /> representing the designer region size on the design surface.</para> + </returns> </Docs> </Member> <Member MemberName="Highlight"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml index ef83c4742ca..e8d6a2d110f 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml @@ -107,7 +107,6 @@ <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerRegionCollection.Add(System.Web.UI.Design.DesignerRegion)" /> method adds the specified <see cref="T:System.Web.UI.Design.DesignerRegion" /> object to the end of the collection. To add a <see cref="T:System.Web.UI.Design.DesignerRegion" /> object to the collection at a specific index location, use the <see cref="M:System.Web.UI.Design.DesignerRegionCollection.Insert(System.Int32,System.Web.UI.Design.DesignerRegion)" /> method.</para> @@ -116,6 +115,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds the specified <see cref="T:System.Web.UI.Design.DesignerRegion" /> object to the end of the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which the region was added to the collection.</para> + </returns> <param name="region"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to add to the collection.</param> </Docs> @@ -154,7 +157,6 @@ <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerRegionCollection.Contains(System.Web.UI.Design.DesignerRegion)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerRegion" /> objects.</para> @@ -164,6 +166,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified region is contained within the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the region is in the collection; otherwise, false.</para> + </returns> <param name="region"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param> </Docs> @@ -228,7 +234,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Use the <see cref="P:System.Web.UI.Design.DesignerRegionCollection.Count" /> property together with a loop construct, such as while, for, or foreach statements, to enumerate through the <see cref="T:System.Web.UI.Design.DesignerRegionCollection" /> object.</para> @@ -237,6 +242,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an enumerator that iterates through the collection.</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> <Member MemberName="IndexOf"> @@ -252,7 +261,6 @@ <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DesignerRegionCollection.IndexOf(System.Web.UI.Design.DesignerRegion)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerRegion" /> objects.</para> @@ -262,6 +270,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of the specified <see cref="T:System.Web.UI.Design.DesignerRegion" /> object within the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The zero-based index of the first occurrence of <paramref name="region" /> within the collection; otherwise, -1, if <paramref name="region" /> is not in the collection.</para> + </returns> <param name="region"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param> </Docs> @@ -578,7 +590,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para> @@ -587,6 +598,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</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> <Member MemberName="System.Collections.IList.Add"> @@ -602,7 +617,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -611,6 +625,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which the item was added to the collection.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The item to add to the collection.</param> </Docs> @@ -649,7 +667,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -658,6 +675,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the region is in the collection; otherwise, false.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param> </Docs> @@ -675,7 +696,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -684,6 +704,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The zero-based index of the first occurrence of the object within the collection; otherwise, -1, if the object is not in the collection.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml index f98282f46af..d0313687e23 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml @@ -98,12 +98,15 @@ <Parameter Name="control" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a <see cref="T:System.Web.UI.Design.ViewRendering" /> object containing the design-time HTML markup for the given control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The control for which to get the <see cref="T:System.Web.UI.Design.ViewRendering" /> object for the current region.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml index d9bd5fa8522..65bcd635136 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml @@ -57,7 +57,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -68,6 +67,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Evaluates an expression string and provides the design-time value for a control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The object referenced by the evaluated expression string, if the expression evaluation succeeded; otherwise, null.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />An expression string to evaluate. The expression does not include the expression prefix.</param> <param name="parseTimeData"> @@ -115,7 +118,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -128,6 +130,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation that is associated with the specified expression prefix.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation associated with <paramref name="expressionPrefix" />; otherwise, null, if <paramref name="expressionPrefix" /> is not defined or is not associated with an <see cref="T:System.Web.UI.Design.ExpressionEditor" />.</para> + </returns> <param name="expressionPrefix"> <attribution license="cc4" from="Microsoft" modified="false" />The expression prefix used to find the associated expression editor.</param> <param name="serviceProvider"> @@ -148,7 +154,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -161,6 +166,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation that is associated with the specified expression builder type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation associated with <paramref name="expressionBuilderType" />; otherwise, null, if <paramref name="expressionBuilderType" /> cannot be located or has no associated <see cref="T:System.Web.UI.Design.ExpressionEditor" />.</para> + </returns> <param name="expressionBuilderType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of the derived expression builder class, used to locate the associated expression editor.</param> <param name="serviceProvider"> @@ -181,7 +190,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -193,6 +201,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an expression editor sheet that is associated with the current expression editor.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.ExpressionEditorSheet" /> that defines the custom expression properties.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />The expression string set for a control property, used to initialize the expression editor sheet.</param> <param name="serviceProvider"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml index 8c34c42a356..3cb4ec6db86 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml @@ -65,7 +65,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -76,6 +75,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, returns the expression string that is formed by the expression editor sheet property values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The custom expression string for the current property values.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>2.0.0.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml index de20065b1fe..0b18b4a5572 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml @@ -60,7 +60,6 @@ <Parameter Name="destinationType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -71,6 +70,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts an expression binding collection to the specified type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>If <paramref name="destinationType" /> is not of type <see cref="T:System.String" />, the object produced by the type conversion; otherwise, if <paramref name="destinationType" /> is a string, an empty string ("").</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that indicates the component or control the expression binding collection belongs to. </param> <param name="culture"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml index 279853aacda..818a5ab6508 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml @@ -51,7 +51,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.EditValue" /> method launches the user interface for editing the <paramref name="value" /> object. The designer host calls the <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.EditValue" /> method when you attempt to edit the value of a property that this editor is associated with. The input service provider is used to obtain any editing services that are required within the <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.EditValue" />.</para> @@ -62,6 +61,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object with the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.ExpressionBindingCollection" /> object containing the selected expressions; otherwise, if no expressions are selected, the <paramref name="value" /> object.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information such as the associated control.</param> <param name="provider"> @@ -83,7 +86,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.GetEditStyle" /> method returns the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.Modal" /> value by default. </para> @@ -93,6 +95,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editing style that is associated with this editor for the specified context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the editing style for the provided user interface.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml index ce58b096ba5..578f49e953b 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml @@ -53,7 +53,6 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.DataSourceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="M:System.Web.UI.Design.HierarchicalDataSourceConverter.IsValidDataSource(System.ComponentModel.IComponent)" /> method to determine which components are available as standard accessible data sources. For the <see cref="T:System.Web.UI.Design.HierarchicalDataSourceConverter" /> class, a valid data source is a component that implements the <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> interface. </para> @@ -62,6 +61,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the specified component is a valid data source for this converter.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="component" /> implements <see cref="T:System.Web.UI.IHierarchicalEnumerable" />; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to check as a valid data source.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml index 44e0306d057..4b39f050ea1 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml @@ -169,12 +169,15 @@ <Parameter Name="viewPath" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the named data source view associated with the data source control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.DesignerHierarchicalDataSourceView" /> object.</para> + </returns> <param name="viewPath"> <attribution license="cc4" from="Microsoft" modified="false" />The unique path to the block of data to use in creating the view.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml index 79c9f92d73c..1a7a59955c8 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml @@ -45,12 +45,15 @@ <Parameter Name="identifier" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the current state of the identified content place holder.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The current state of the identified content placeholder.</para> + </returns> <param name="identifier"> <attribution license="cc4" from="Microsoft" modified="false" />The identifier for a content place holder.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml index 6c586809988..1c6f1e161ab 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml @@ -30,12 +30,15 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the value of the identified attribute on the tag.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string containing the value of the attribute.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute.</param> </Docs> @@ -51,12 +54,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the HTML markup for the content of the tag.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML markup for the content of the tag.</para> + </returns> </Docs> </Member> <Member MemberName="GetOuterContent"> @@ -70,12 +76,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the complete HTML markup for the control, including the outer tags.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The outer HTML markup for the control.</para> + </returns> </Docs> </Member> <Member MemberName="IsDirty"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml index 19345ad712b..40c05ec217c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml @@ -48,12 +48,15 @@ <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the outer bounds of the designer view.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Rectangle" /> containing information about the location and measurements of the view at design time.</para> + </returns> <param name="region"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> for which you want to retrieve the bounds.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml index 8c170e18a43..15dc02bdf8d 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml @@ -111,7 +111,6 @@ <Parameter Name="viewName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A class that implements <see cref="T:System.Web.UI.Design.IDataSourceDesigner" /> can define a view in a way that is useful within the context of that class.</para> @@ -121,6 +120,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the <see cref="T:System.Web.UI.Design.DesignerDataSourceView" /> for the specified view.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.DesignerDataSourceView" /> containing information about the identified view, or null if a view with the specified name is not found.</para> + </returns> <param name="viewName"> <attribution license="cc4" from="Microsoft" modified="false" />The name of a view in the underlying data source.</param> </Docs> @@ -136,12 +139,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the names of the views in the underlying data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of type <see cref="T:System.String" />.</para> + </returns> </Docs> </Member> <Member MemberName="RefreshSchema"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml index 6778351b7b9..485f960fd85 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml @@ -26,12 +26,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the selected data member from the selected data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The selected data member from the selected data source, if the control allows the user to select an <see cref="T:System.ComponentModel.IListSource" /> (such as a <see cref="T:System.Data.DataSet" />) for the data source, and provides a DataMember property to select a particular list (or <see cref="T:System.Data.DataTable" />) within the data source.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -46,12 +49,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a reference to the selected data source from the data source provider.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The currently selected data source object of this data source provider.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml index f81f0aa91c4..5b002a42300 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml @@ -29,7 +29,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A class that implements the <see cref="M:System.Web.UI.Design.IDataSourceSchema.GetViews" /> method returns an array of objects that implement the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface. For example, in the array returned by the <see cref="M:System.Web.UI.Design.DataSetSchema.GetViews" /> method, each element of the array is a <see cref="T:System.Web.UI.Design.DataSetViewSchema" /> object that implements <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" />.</para> @@ -38,6 +37,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array of schema descriptors for views contained in the data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml index 0c5c34bc777..faaa5978a2c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml @@ -28,7 +28,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.Web.UI.Design.XmlDocumentSchema" /> class implements the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface. It uses its implementation of the <see cref="M:System.Web.UI.Design.IDataSourceViewSchema.GetChildren" /> method to create an array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para> @@ -37,6 +36,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array representing the child views contained in the current view.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects that represent the child views contained in the current view.</para> + </returns> </Docs> </Member> <Member MemberName="GetFields"> @@ -50,7 +53,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.Web.UI.Design.DataSetSchema" /> class implements the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface; its implementation of the <see cref="M:System.Web.UI.Design.DataSetViewSchema.GetFields" /> method returns an array of <see cref="T:System.Web.UI.Design.DataSetFieldSchema" /> objects, each of which derives from the <see cref="T:System.Web.UI.Design.IDataSourceFieldSchema" /> interface.</para> @@ -59,6 +61,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array containing information about each field in the data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceFieldSchema" /> objects representing each of the fields in the data source.</para> + </returns> </Docs> </Member> <Member MemberName="Name"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml index 8a65b3e3f79..d947d87712a 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml @@ -25,12 +25,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a <see cref="T:System.Web.UI.Design.DesignTimeResourceProviderFactory" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A design time resource provider factory.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml index 2e211a63481..7423283311c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml @@ -32,12 +32,15 @@ <Parameter Name="obj" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a key, using the provided string, to use to retrieve data from the given resource.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The key used to write or retrieve <paramref name="obj" /> from <paramref name="resourceName" />.</para> + </returns> <param name="resourceName"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource.</param> <param name="obj"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml index c314979d04f..3ec1e8d0cde 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml @@ -25,12 +25,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides access to the contents of a document item that is retrieved from the design host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.IO.Stream" /> object.</para> + </returns> </Docs> </Member> <Member MemberName="Open"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml index 48999b6b7e3..4959b5b5065 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml @@ -28,12 +28,15 @@ <Parameter Name="content" Type="System.Byte[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds a document to a project folder in a design host, such as vsprvslong.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.IDocumentProjectItem" /> representing the added document.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the document.</param> <param name="content"> @@ -53,12 +56,15 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new folder in a project folder of a design host, such as vsprvslong.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.Design.IFolderProjectItem" /> representing the new folder.</para> + </returns> <param name="name"> <attribution license="cc4" from="Microsoft" modified="false" />The name for the new folder.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml index 82d3c8b1081..50ffe92f352 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml @@ -107,12 +107,15 @@ <Parameter Name="viewPath" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the named data source view that is associated with the data source control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The named data source view that is associated with the data source control.</para> + </returns> <param name="viewPath"> <attribution license="cc4" from="Microsoft" modified="false" />The XPath for the part of the data source to retrieve.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml index dd85eb3e108..ad009fe148b 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml @@ -69,7 +69,6 @@ <Parameter Name="ignoreCase" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -80,6 +79,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the specified attribute.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The attribute that was retrieved.</para> + </returns> <param name="attribute"> <attribution license="cc4" from="Microsoft" modified="false" />The attribute to retrieve. </param> <param name="ignoreCase"> @@ -102,7 +105,6 @@ <Parameter Name="ignoreCase" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -113,6 +115,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the specified style attribute.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The style attribute that was retrieved.</para> + </returns> <param name="attribute"> <attribution license="cc4" from="Microsoft" modified="false" />The style attribute to retrieve. </param> <param name="designTimeOnly"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml index 1dc081f17d0..6ecd8d758a4 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml @@ -32,7 +32,6 @@ <Parameter Name="templateNames" Type="System.String[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -43,6 +42,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new template editing frame for the specified templated control designer, using the specified name and templates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para> + </returns> <param name="designer"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame. </param> <param name="frameName"> @@ -69,7 +72,6 @@ <Parameter Name="templateStyles" Type="System.Web.UI.WebControls.Style[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -80,6 +82,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new template editing frame for the specified <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" />, using the specified name, template names, control style, and template styles.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para> + </returns> <param name="designer"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame. </param> <param name="frameName"> @@ -106,7 +112,6 @@ <Parameter Name="control" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -117,6 +122,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the name of the parent template.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The name of the parent template.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> for which to get the name of the parent template. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml index c1951d215e9..ccab5661ae8 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml @@ -34,13 +34,16 @@ <Parameter Name="appRelativeUrl" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <since version=".NET 2.0" /> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a project item from a design host based on its URL.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A project item from a design host based on its URL.</para> + </returns> <param name="appRelativeUrl"> <attribution license="cc4" from="Microsoft" modified="false" />The relative path to the project item to retrieve.</param> </Docs> @@ -58,13 +61,16 @@ <Parameter Name="isReadOnly" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <since version=".NET 2.0" /> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a <see cref="T:System.Configuration.Configuration" /> object representing the current Web application in the design host.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object representing the current Web application in the design host.</para> + </returns> <param name="isReadOnly"> <attribution license="cc4" from="Microsoft" modified="false" />true to indicate the returned <see cref="T:System.Configuration.Configuration" /> is editable; otherwise, false.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml index b70a8bc1d35..ff35398b29d 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml @@ -32,7 +32,6 @@ <Parameter Name="typeName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -43,6 +42,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the type of the specified object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Type" /> of the object, if it could be resolved.</para> + </returns> <param name="tagPrefix"> <attribution license="cc4" from="Microsoft" modified="false" />The tag prefix for the type. </param> <param name="typeName"> @@ -61,7 +64,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -72,6 +74,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the register directives for the current project.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The register directives for the current project.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -88,7 +94,6 @@ <Parameter Name="objectType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -99,6 +104,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the tag prefix for the specified type of object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The tag prefix for the specified object type, if it could be located.</para> + </returns> <param name="objectType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of the object. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml index 54a70d0f491..424aac83a26 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml @@ -26,7 +26,6 @@ <Parameter Name="initialColor" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <paramref name="initialColor" /> parameter should be a named color, or an RGB color expressed in HTML color format (#RRGGBB).</para> @@ -35,6 +34,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Starts a <see cref="T:System.Web.UI.Design.ColorBuilder" /> to build a color property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The color that was selected. This value will be a named color, or an RGB color expressed in HTML color format (#RRGGBB).</para> + </returns> <param name="owner"> <attribution license="cc4" from="Microsoft" modified="false" />The control used to parent the dialog shown by the <see cref="T:System.Web.UI.Design.ColorBuilder" />. </param> <param name="initialColor"> @@ -60,12 +63,15 @@ <Parameter Name="options" Type="System.Web.UI.Design.UrlBuilderOptions" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Launches an editor to build a URL property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that contains the URL returned by the <see cref="T:System.Web.UI.Design.UrlBuilder" />.</para> + </returns> <param name="owner"> <attribution license="cc4" from="Microsoft" modified="false" />The control used to parent the dialog shown by the <see cref="T:System.Web.UI.Design.UrlBuilder" />. </param> <param name="initialUrl"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml index b952efa5547..9869082d307 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml @@ -28,7 +28,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method is obsolete and there is no equivalent functionality.</para> @@ -37,6 +36,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a discardable undo unit.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new discardable undo unit.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml index a60b208e986..cc408d9c032 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml @@ -56,7 +56,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -67,6 +66,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the HTML that is used to represent the control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML that is used to represent the control at design time.</para> + </returns> </Docs> </Member> <Member MemberName="MapPropertyToStyle"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml index a0b0073e5e0..31e55c2d210 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml @@ -57,7 +57,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -69,6 +68,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Evaluates a resource expression and provides the design-time value for a control property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The object referenced by the evaluated expression string, if the expression evaluation succeeded; otherwise, null.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />A resource expression to evaluate. <paramref name="expression" /> does not include the Resources expression prefix.</param> <param name="parseTimeData"> @@ -93,7 +96,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <since version=".NET 2.0" /> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> @@ -103,6 +105,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a resource expression editor sheet that is initialized with the input expression string and service provider implementation.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Web.UI.Design.ResourceExpressionEditorSheet" /> that defines the resource expression properties.</para> + </returns> <param name="expression"> <attribution license="cc4" from="Microsoft" modified="false" />A resource expression, used to initialize the expression editor sheet.</param> <param name="serviceProvider"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml index dfaf4d32755..90bc2f743d2 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml @@ -84,12 +84,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a resource expression that is formed by the expression editor sheet property values.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The resource expression string for the current settings in the sheet.</para> + </returns> </Docs> </Member> <Member MemberName="IsValid"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml index 29704696a6a..01f43801e30 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml @@ -46,12 +46,15 @@ <Parameter Name="sourceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether this converter can convert a <see cref="P:System.Web.UI.Control.SkinID" /> object to a string using the provided format context and type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if the conversion can be made; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context for the control being designed.</param> <param name="sourceType"> @@ -72,12 +75,15 @@ <Parameter Name="destType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether this converter can convert a <see cref="P:System.Web.UI.Control.SkinID" /> object to the specified type, using the specified context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if a conversion can be made; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context for the control being designed.</param> <param name="destType"> @@ -99,12 +105,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the given string to a <see cref="P:System.Web.UI.Control.SkinID" /> object using the specified context and culture information.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that can be cast as a <see cref="P:System.Web.UI.DataSourceControl.SkinID" /> object, if the conversion can be made; otherwise, null.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context that represents the control being designed.</param> <param name="culture"> @@ -129,12 +138,15 @@ <Parameter Name="destinationType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the given <see cref="P:System.Web.UI.Control.SkinID" /> object to a string using the specified context and culture information.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that represents the converted value.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context that represents the control being designed.</param> <param name="culture"> @@ -158,12 +170,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a set of <see cref="P:System.Web.UI.Control.SkinID" /> objects that can be applied to the control that is represented by the given format context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a set of <see cref="P:System.Web.UI.Control.SkinID" /> objects; otherwise, null, if the control does not support skins.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context that represents the control being designed. <paramref name="context" /> or properties of <paramref name="context" /> can be null.</param> </Docs> @@ -181,12 +196,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether the control that is represented by the given context supports a set of <see cref="P:System.Web.UI.Control.SkinID" /> objects that can be picked from a list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if <see cref="Overload:System.Web.UI.Design.SkinIDTypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> for the control being designed.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml index 8264816d38e..2f07cc438f7 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml @@ -90,7 +90,6 @@ <Parameter Name="obj" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.SupportsPreviewControlAttribute.Equals(System.Object)" /> method overrides the <see cref="M:System.Object.Equals(System.Object)" /> method.</para> @@ -100,6 +99,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the specified object represents the same preview attribute setting as the current instance of the <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> class.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="obj" /> is a <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> attribute and its value is the same as this instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" />; otherwise, false.</para> + </returns> <param name="obj"> <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" />.</param> </Docs> @@ -115,7 +118,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.SupportsPreviewControlAttribute.GetHashCode" /> method overrides the <see cref="M:System.Object.GetHashCode" /> method.</para> @@ -125,6 +127,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the hash code for this instance of the <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> class.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A 32-bit signed integer hash code for the current instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" />.</para> + </returns> </Docs> </Member> <Member MemberName="IsDefaultAttribute"> @@ -138,7 +144,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.SupportsPreviewControlAttribute.IsDefaultAttribute" /> method compares the value for the <see cref="P:System.Web.UI.Design.SupportsPreviewControlAttribute.SupportsPreviewControl" /> property of the current <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> object with the value for the <see cref="P:System.Web.UI.Design.SupportsPreviewControlAttribute.SupportsPreviewControl" /> property of the static <see cref="F:System.Web.UI.Design.SupportsPreviewControlAttribute.Default" /> field.</para> @@ -147,6 +152,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the current instance of the <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> class is set to the default preview attribute value.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the current instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> is equal to the default preview attribute value; otherwise, false.</para> + </returns> </Docs> </Member> <Member MemberName="SupportsPreviewControl"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml index 283c9d6f827..bb71b403f29 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml @@ -67,7 +67,6 @@ <Parameter Name="templateNames" Type="System.String[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -78,6 +77,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new template editing frame for the specified templated control designer, using the specified name and templates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para> + </returns> <param name="designer"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame.</param> <param name="frameName"> @@ -104,7 +107,6 @@ <Parameter Name="templateStyles" Type="System.Web.UI.WebControls.Style[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -115,6 +117,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a new template editing frame for the specified <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> object, using the specified name, template names, control style, and template styles.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para> + </returns> <param name="designer"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame. </param> <param name="frameName"> @@ -176,7 +182,6 @@ <Parameter Name="control" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -187,6 +192,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the name of the parent template.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The name of the parent template.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> for which to get the name of the parent template. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml index b580ae3fc54..c56d0fe9687 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml @@ -87,7 +87,6 @@ <Parameter Name="group" Type="System.Web.UI.Design.TemplateGroup" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.TemplateGroupCollection.Add(System.Web.UI.Design.TemplateGroup)" /> method adds the specified <see cref="T:System.Web.UI.Design.TemplateGroup" /> object to the end of the collection. To add a <see cref="T:System.Web.UI.Design.TemplateGroup" /> object to the collection at a specific index location, use the <see cref="M:System.Web.UI.Design.TemplateGroupCollection.Insert(System.Int32,System.Web.UI.Design.TemplateGroup)" /> method.</para> @@ -97,6 +96,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds the specified <see cref="T:System.Web.UI.Design.TemplateGroup" /> object to the end of the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which the <see cref="T:System.Web.UI.Design.TemplateGroup" /> was added to the collection.</para> + </returns> <param name="group"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to add to the collection.</param> </Docs> @@ -160,7 +163,6 @@ <Parameter Name="group" Type="System.Web.UI.Design.TemplateGroup" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.TemplateGroupCollection.Contains(System.Web.UI.Design.TemplateGroup)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.TemplateGroup" /> objects.</para> @@ -170,6 +172,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the specified group is contained within the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <paramref name="group" /> is in the collection; otherwise, false.</para> + </returns> <param name="group"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param> </Docs> @@ -236,7 +242,6 @@ <Parameter Name="group" Type="System.Web.UI.Design.TemplateGroup" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.TemplateGroupCollection.IndexOf(System.Web.UI.Design.TemplateGroup)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.TemplateGroup" /> objects.</para> @@ -246,6 +251,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of the specified <see cref="T:System.Web.UI.Design.TemplateGroup" /> object within the collection.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The zero-based index of the first occurrence of <paramref name="group" /> within the collection; otherwise, -1, if <paramref name="group" /> is not in the collection.</para> + </returns> <param name="group"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param> </Docs> @@ -461,7 +470,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para> @@ -470,6 +478,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.IEnumerator" /> to use to iterate through the collection.</para> + </returns> </Docs> </Member> <Member MemberName="System.Collections.IList.Add"> @@ -485,7 +497,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -494,6 +505,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which <paramref name="o" /> was added to the collection.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to add to the collection.</param> </Docs> @@ -532,7 +547,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -541,6 +555,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true, if <paramref name="o" /> is in the collection; otherwise, false.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param> </Docs> @@ -558,7 +576,6 @@ <Parameter Name="o" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para> @@ -567,6 +584,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The zero-based index of the first occurrence of <paramref name="o" /> within the collection; otherwise, -1, if <paramref name="o" /> is not in the collection.</para> + </returns> <param name="o"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml index f033eb782d9..efee40c1d20 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml @@ -92,12 +92,15 @@ <Parameter Name="verb" Type="System.Web.UI.Design.TemplateEditingVerb" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, creates a template editing frame for the specified verb.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new template editing frame.</para> + </returns> <param name="verb"> <attribution license="cc4" from="Microsoft" modified="false" />The template editing verb to create a template editing frame for. </param> </Docs> @@ -210,7 +213,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -221,6 +223,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the cached template editing verbs.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.TemplateEditingVerb" /> objects, if any.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -240,12 +246,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup to persist for the content that is in the associated server control runtime.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The persistable inner HTML.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -261,7 +270,6 @@ <Parameter Name="templateName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -272,6 +280,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data item property of the template's container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string representing the data.</para> + </returns> <param name="templateName"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the template. </param> </Docs> @@ -295,12 +307,15 @@ <Parameter Name="templateName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the data source of the template's container.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The data source of the container of the specified template.</para> + </returns> <param name="templateName"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the template. </param> </Docs> @@ -351,12 +366,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the template editing verbs available to the designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The template editing verbs available to the designer.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -378,12 +396,15 @@ <Parameter Name="text" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a template from the specified text.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Web.UI.ITemplate" /> from the specified text.</para> + </returns> <param name="text"> <attribution license="cc4" from="Microsoft" modified="false" />The text to retrieve a template from. </param> </Docs> @@ -402,7 +423,6 @@ <Parameter Name="templateName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <block subset="none" type="note"> @@ -413,6 +433,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the type of the parent of the template property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The type of the object that has the template property.</para> + </returns> <param name="templateName"> <attribution license="cc4" from="Microsoft" modified="false" />The name of the template to return the type of the parent for. </param> </Docs> @@ -436,12 +460,15 @@ <Parameter Name="template" Type="System.Web.UI.ITemplate" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a string of text that represents the specified template.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string that represents the specified template.</para> + </returns> <param name="template"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.ITemplate" /> to convert to text. </param> </Docs> @@ -645,6 +672,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Allows a designer to filter the set of member attributes the component it is designing through a <see cref="T:System.ComponentModel.TypeDescriptor" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The augmented set of attributes. If the method does not modify any attributes, it returns a reference to its input parameter. If you do make a change to the attributes, you must create a new array.</para> + </returns> <param name="properties"> <attribution license="cc4" from="Microsoft" modified="false" />The member attributes for component. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml index 59a3c0eca93..1c371dcbdf5 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml @@ -45,7 +45,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This class overrides this method to ensure that a non-empty Text property value is available when the control is rendered for display on the design surface. This makes sure that the class has a meaningful representation. This method sets any empty Text property of the control to the <see cref="P:System.Web.UI.Control.ID" /> property of the control.</para> @@ -54,6 +53,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup that is used to represent the associated control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup that is used to represent the control at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -68,12 +71,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the markup to persist for the inner tags of the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup for the tags of the control.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml index 0a4ecc1e0d8..26803a9714c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml @@ -55,7 +55,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Although the <see cref="M:System.Web.UI.Design.TypeSchema.GetViews" /> method always returns an array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects that implement the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface, the exact return value is dependent on the object that is provided when creating the instance of the <see cref="T:System.Web.UI.Design.TypeSchema" /> class.</para> @@ -109,6 +108,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array of schema descriptors for views into a data source.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of instances of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" />, or of instances of a class that implements the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml index 72a13ef7fe4..5624b1d2656 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml @@ -35,12 +35,15 @@ <Parameter Name="filter" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a UI to create or pick a URL.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The URL returned from the UI.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> whose site is to be used to access design-time services. </param> <param name="owner"> @@ -72,12 +75,15 @@ <Parameter Name="options" Type="System.Web.UI.Design.UrlBuilderOptions" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a UI to create or pick a URL, using the specified <see cref="T:System.Web.UI.Design.UrlBuilderOptions" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The URL returned from the UI.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> whose site is to be used to access design-time services. </param> <param name="owner"> @@ -114,7 +120,6 @@ <Parameter Name="options" Type="System.Web.UI.Design.UrlBuilderOptions" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="T:System.IServiceProvider" /> interface is used to obtain the <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation for the designer host. </para> @@ -123,6 +128,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates a UI to create or pick a URL, using the specified <see cref="T:System.Web.UI.Design.UrlBuilderOptions" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The URL returned from the UI.</para> + </returns> <param name="serviceProvider"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IServiceProvider" /> to be used to access design-time services.</param> <param name="owner"> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml index aa456779968..84379eb1007 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml @@ -69,12 +69,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object using the editor style provided by the <see cref="M:System.Web.UI.Design.UrlEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this method should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> <param name="provider"> @@ -124,12 +127,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editing style of the <see cref="M:System.Web.UI.Design.UrlEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values indicating the provided editing style. If the method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml index 6ceebca4bd7..941ab7b43b7 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml @@ -85,12 +85,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the HTML markup that is used to represent the user control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The markup that is used to represent the control at design time.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -105,12 +108,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This member overrides <see cref="M:System.Web.UI.Design.ControlDesigner.GetPersistInnerHtml" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The persistable inner HTML markup of the control.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml index ad463507623..7d2c6278932 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml @@ -110,7 +110,6 @@ <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para> @@ -120,6 +119,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Creates objects from each type contained in this <see cref="T:System.Drawing.Design.ToolboxItem" />, and adds them to the specified designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para> + </returns> <param name="host"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param> </Docs> @@ -165,7 +168,6 @@ <Parameter Name="attributeType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation will throw an <see cref="T:System.ArgumentException" /> if the <paramref name="attributeType" /> parameter is anything other than a <see cref="T:System.Web.UI.PersistChildrenAttribute" />.</para> @@ -174,6 +176,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the value of the specified type of attribute of the toolbox item.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The value of the specified type of attribute.</para> + </returns> <param name="host"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param> <param name="attributeType"> @@ -194,12 +200,15 @@ <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the HTML for the Web control that the tool creates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The HTML for the Web control that the tool creates.</para> + </returns> <param name="host"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param> </Docs> @@ -218,12 +227,15 @@ <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the type of this toolbox item.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Type" /> of this toolbox item.</para> + </returns> <param name="host"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml index e0eb9f696c4..a042504817d 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml @@ -63,12 +63,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the register directives for the current project document.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of strings representing the register directives defined in the current document.</para> + </returns> </Docs> </Member> <Member MemberName="GetTagPrefix"> @@ -84,12 +87,15 @@ <Parameter Name="objectType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the tag prefix for the specified object type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The tag prefix for the specified object type, if found; otherwise, null.</para> + </returns> <param name="objectType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of the object.</param> </Docs> @@ -108,12 +114,15 @@ <Parameter Name="tagName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the object type with the specified tag prefix and tag name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Type" /> of the object with the specified tag prefix and name, if found; otherwise, null.</para> + </returns> <param name="tagPrefix"> <attribution license="cc4" from="Microsoft" modified="false" />The tag prefix of the type to retrieve.</param> <param name="tagName"> @@ -134,7 +143,6 @@ <Parameter Name="tagName" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para> @@ -144,6 +152,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the relative URL path for the user control with the specified tag prefix and tag name.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A string representing the relative URL path for the specified user control, if found; otherwise, null.</para> + </returns> <param name="tagPrefix"> <attribution license="cc4" from="Microsoft" modified="false" />The tag prefix of the user control to retrieve.</param> <param name="tagName"> @@ -163,7 +175,6 @@ <Parameter Name="objectType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the tag prefix already exists, then a new register directive is not added.</para> @@ -172,6 +183,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds a tag prefix for the specified type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The tag prefix string.</para> + </returns> <param name="objectType"> <attribution license="cc4" from="Microsoft" modified="false" />The type to add a tag prefix for in the current document.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml index 1b7520eedc2..af260b8607e 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml @@ -79,7 +79,6 @@ <Parameter Name="location" Type="System.Web.UI.Design.ControlLocation" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Although a control might already have an ID assigned to it, if there is already a control in the Web Forms page with the same ID, a new ID is assigned.</para> @@ -88,6 +87,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, adds a Web server control to the Web Forms page.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The ID of the control that was added.</para> + </returns> <param name="newControl"> <attribution license="cc4" from="Microsoft" modified="false" />The control to add to the Web Forms page.</param> <param name="referenceControl"> @@ -130,7 +133,6 @@ <Parameter Name="serviceProvider" Type="System.IServiceProvider" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebFormsRootDesigner.CreateDesignerActionService(System.IServiceProvider)" /> method is called by a control designer and provides a way for action items for the control designer to be implemented in the Web Forms page through a design host, such as vsprvslong.</para> @@ -139,6 +141,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a design-time <see cref="T:System.ComponentModel.Design.DesignerActionService" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A design-time designer action service object.</para> + </returns> <param name="serviceProvider"> <attribution license="cc4" from="Microsoft" modified="false" />A design host, such as vsprvslong, cast as an <see cref="T:System.IServiceProvider" />.</param> </Docs> @@ -154,12 +160,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an <see cref="T:System.Web.UI.IUrlResolutionService" /> that resolves relative URLs.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that resolves relative URLs.</para> + </returns> </Docs> </Member> <Member MemberName="CurrentCulture"> @@ -251,7 +260,6 @@ <Parameter Name="control" Type="System.Web.UI.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Web.UI.Design.WebFormsRootDesigner.GenerateEmptyDesignTimeHtml(System.Web.UI.Control)" /> method enables a consistent display of empty controls at design time.</para> @@ -260,6 +268,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates empty HTML markup for a control at design time.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>HTML markup for an empty control.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The control to generate HTML markup for.</param> </Docs> @@ -279,12 +291,15 @@ <Parameter Name="errorMessage" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates HTML markup that is used to display an error message at design time by using the specified control, exception, and message.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>HTML markup for a control and exception information.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The control that raised the exception.</param> <param name="e"> @@ -304,12 +319,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>When overridden in a derived class, returns a <see cref="T:System.Web.UI.Design.ClientScriptItemCollection" /> object that contains all client script items that are on the page.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that contains all client script items that are on the page.</para> + </returns> </Docs> </Member> <Member MemberName="GetControlViewAndTag"> @@ -347,12 +365,15 @@ <Parameter Name="serviceType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the requested service.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The requested service; otherwise, null, if the service cannot be resolved.</para> + </returns> <param name="serviceType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve.</param> </Docs> @@ -370,12 +391,15 @@ <Parameter Name="viewTechnology" Type="System.ComponentModel.Design.ViewTechnology" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a view object that is determined by the provided <see cref="T:System.ComponentModel.Design.ViewTechnology" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object containing the current view of the component.</para> + </returns> <param name="viewTechnology"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> obtained from the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.SupportedTechnologies" /> property.</param> </Docs> @@ -684,12 +708,15 @@ <Parameter Name="relativeUrl" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts a relative URL into a fully qualified URL.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A fully qualified URL resolved from <paramref name="relativeUrl" />.</para> + </returns> <param name="relativeUrl"> <attribution license="cc4" from="Microsoft" modified="false" />A relative URL for a resource on the site.</param> </Docs> @@ -942,7 +969,6 @@ <Parameter Name="viewTechnology" Type="System.ComponentModel.Design.ViewTechnology" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Web.UI.Design.WebFormsRootDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para> @@ -951,6 +977,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a view object for the specified view technology. For a description of this member, see <see cref="M:System.ComponentModel.Design.IRootDesigner.GetView(System.ComponentModel.Design.ViewTechnology)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The view object for the specified view technology.</para> + </returns> <param name="viewTechnology"> <attribution license="cc4" from="Microsoft" modified="false" /> The view technology.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml index 96806c5e1d7..f35af22e205 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml @@ -60,12 +60,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array containing information about each child node starting at the node identified by the <paramref name="xPath" /> parameter in the constructor, or each child node starting at the document root if the <paramref name="xPath" /> parameter is empty.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml index c87ee926ab7..86b809ad941 100644 --- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml @@ -50,7 +50,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A service provider is provided so that any required editing services can be obtained.</para> @@ -59,6 +58,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object using the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object has not changed, this method should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -81,12 +84,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editing style associated with this editor, using the specified <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the provided editing style. If the method is not supported in the specified context, this will return the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" /> identifier.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml index 0bc3b2718ac..de399da0552 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml @@ -157,7 +157,6 @@ <Parameter Name="commandId" Type="System.ComponentModel.Design.CommandID" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.FindCommand(System.ComponentModel.Design.CommandID)" /> method is called from the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. It provides an opportunity for the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> to return its own custom <see cref="T:System.ComponentModel.Design.MenuCommand" />, thereby intercepting this message.</para> @@ -166,6 +165,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Intercepts commands.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.ComponentModel.Design.MenuCommand" />. By default, <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.FindCommand(System.ComponentModel.Design.CommandID)" /> returns null.</para> + </returns> <param name="commandId"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.CommandID" /> object.</param> </Docs> @@ -350,7 +353,6 @@ <Parameter Name="mouseLoc" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any double-click message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para> @@ -359,6 +361,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any double-click message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</param> <param name="button"> @@ -382,7 +388,6 @@ <Parameter Name="mouseLoc" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-down message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para> @@ -391,6 +396,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any mouse-down message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param> <param name="button"> @@ -412,7 +421,6 @@ <Parameter Name="g" Type="System.Windows.Forms.Design.Behavior.Glyph" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-enter message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. From here, the message is sent to the appropriate behavior.</para> @@ -422,6 +430,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any mouse-enter message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param> </Docs> @@ -440,7 +452,6 @@ <Parameter Name="mouseLoc" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-hover message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para> @@ -449,6 +460,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any mouse-hover message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param> <param name="mouseLoc"> @@ -468,7 +483,6 @@ <Parameter Name="g" Type="System.Windows.Forms.Design.Behavior.Glyph" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-leave message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. From here, the message is sent to the appropriate behavior.</para> @@ -478,6 +492,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any mouse-leave message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</param> </Docs> @@ -497,7 +515,6 @@ <Parameter Name="mouseLoc" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-move message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para> @@ -506,6 +523,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any mouse-move message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param> <param name="button"> @@ -528,7 +549,6 @@ <Parameter Name="button" Type="System.Windows.Forms.MouseButtons" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-up message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para> @@ -537,6 +557,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Called when any mouse-up message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the message was handled; otherwise, false.</para> + </returns> <param name="g"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param> <param name="button"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml index 953807914c3..286193083f6 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml @@ -78,12 +78,15 @@ <Parameter Name="p" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Translates a <see cref="T:System.Drawing.Point" /> in the adorner window to screen coordinates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The transformed <see cref="T:System.Drawing.Point" /> value, in screen coordinates.</para> + </returns> <param name="p"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> value to transform.</param> </Docs> @@ -99,12 +102,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the location of the adorner window in screen coordinates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The location, from the upper-left corner of the adorner window, in screen coordinates.</para> + </returns> </Docs> </Member> <Member MemberName="BeginDrag"> @@ -141,7 +147,6 @@ <Parameter Name="c" Type="System.Windows.Forms.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The adorner window is a transparent window that resides on top of the designer's frame. This window is used by the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" /> to intercept all messages. It also serves as a unified canvas on which to paint a <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</para> @@ -150,6 +155,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the bounding <see cref="T:System.Drawing.Rectangle" /> of a <see cref="T:System.Windows.Forms.Control" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The bounding <see cref="T:System.Drawing.Rectangle" /> of a <see cref="T:System.Windows.Forms.Control" /> translated to the adorner window coordinates.</para> + </returns> <param name="c"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to translate.</param> </Docs> @@ -167,12 +176,15 @@ <Parameter Name="c" Type="System.Windows.Forms.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the location of a <see cref="T:System.Windows.Forms.Control" /> translated to adorner window coordinates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Point" /> value indicating the location of <paramref name="c" /> in adorner window coordinates.</para> + </returns> <param name="c"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to translate.</param> </Docs> @@ -253,12 +265,15 @@ <Parameter Name="behavior" Type="System.Windows.Forms.Design.Behavior.Behavior" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> immediately after the given <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> immediately after <paramref name="behavior" /> in the behavior stack, or null if there is no following behavior.</para> + </returns> <param name="behavior"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> preceding the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> to be returned.</param> </Docs> @@ -348,12 +363,15 @@ <Parameter Name="pt" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts a point in a handle's coordinate system to the adorner window coordinates.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Point" /> in the adorner window coordinates.</para> + </returns> <param name="handle"> <attribution license="cc4" from="Microsoft" modified="false" />An adorner window's handle.</param> <param name="pt"> @@ -373,7 +391,6 @@ <Parameter Name="behavior" Type="System.Windows.Forms.Design.Behavior.Behavior" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Removes the current <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> from the behavior stack internally maintained by the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> @@ -382,6 +399,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Removes and returns the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> at the top of the stack.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> that was removed from the stack.</para> + </returns> <param name="behavior"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> to remove from the stack.</param> </Docs> @@ -449,12 +470,15 @@ <Parameter Name="p" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Translates a point in screen coordinates into the adorner window coordinates of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The transformed <see cref="T:System.Drawing.Point" /> value, in adorner window coordinates.</para> + </returns> <param name="p"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> value to transform.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml index c4502eede27..79864b11b0d 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml @@ -87,12 +87,15 @@ <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Adorner" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds an <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> with the specified value to the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which the new element was inserted.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> to add to the end of the collection.</param> </Docs> @@ -154,12 +157,15 @@ <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Adorner" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" /> contains the specified <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> is contained in the collection; otherwise, false</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> to locate.</param> </Docs> @@ -200,12 +206,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns an enumerator that can iterate through the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" /> instance.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" /> instance.</para> + </returns> </Docs> </Member> <Member MemberName="IndexOf"> @@ -221,12 +230,15 @@ <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Adorner" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of an <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> of <paramref name="value" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />, if found; otherwise, -1.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> to locate.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml index f20dcea85cb..d5b549a261c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml @@ -69,12 +69,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Advances the enumerator to the next element of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the enumerator was successfully advanced to the next element; false if the enumerator was past the end of the collection.</para> + </returns> </Docs> </Member> <Member MemberName="Reset"> @@ -127,7 +130,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollectionEnumerator" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para> @@ -136,6 +138,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the enumerator was successfully advanced to the next element; false if the enumerator was past the end of the collection.</para> + </returns> </Docs> </Member> <Member MemberName="System.Collections.IEnumerator.Reset"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml index b3c0a53807f..3e1d8ca2643 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml @@ -74,7 +74,6 @@ <Parameter Name="p" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The default implementation does nothing and returns null.</para> @@ -83,6 +82,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether a mouse click at the specified point should be handled by the <see cref="T:System.Windows.Forms.Design.Behavior.ComponentGlyph" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Windows.Forms.Cursor" /> if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is associated with <paramref name="p" />; otherwise, null.</para> + </returns> <param name="p"> <attribution license="cc4" from="Microsoft" modified="false" />A point to hit-test.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml index 2a39c07c08d..01479e1c3b6 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml @@ -107,12 +107,15 @@ <Parameter Name="p" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether a mouse click at the specified point should be handled by the <see cref="T:System.Windows.Forms.Design.Behavior.ControlBodyGlyph" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Windows.Forms.Cursor" /> if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is associated with <paramref name="p" />; otherwise, null.</para> + </returns> <param name="p"> <attribution license="cc4" from="Microsoft" modified="false" />A point to hit test.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml index 5d374738ecf..83d75150d69 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml @@ -89,7 +89,6 @@ <Parameter Name="p" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Glyph.GetHitTest(System.Drawing.Point)" /> method is an abstract method that forces <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> implementations to provide hit test logic. Given any point, if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> has decided to be involved with that location, it will need to return a valid <see cref="T:System.Windows.Forms.Cursor" />. Otherwise, returning null will cause the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" /> to ignore the location.</para> @@ -98,6 +97,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides hit test logic.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Windows.Forms.Cursor" /> if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is associated with <paramref name="p" />; otherwise, null.</para> + </returns> <param name="p"> <attribution license="cc4" from="Microsoft" modified="false" />A point to hit-test.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml index fb4251a0407..48565b846be 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml @@ -83,12 +83,15 @@ <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Glyph" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Adds a <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> with the specified value to the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index at which the new element was inserted.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to add to the end of the collection.</param> </Docs> @@ -150,12 +153,15 @@ <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Glyph" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" /> contains the specified <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is contained in the collection; otherwise, false.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to locate.</param> </Docs> @@ -198,12 +204,15 @@ <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Glyph" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the index of a <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The index of the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> of <paramref name="value" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" />, if found; otherwise, -1.</para> + </returns> <param name="value"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to locate.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml index 219c2357ac1..93b5a97b44c 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml @@ -385,12 +385,15 @@ <Parameter Name="line2" Type="System.Windows.Forms.Design.Behavior.SnapLine" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether the specified <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" /> should snap to another <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="line1" /> should snap to <paramref name="line2" />; otherwise, false.</para> + </returns> <param name="line1"> <attribution license="cc4" from="Microsoft" modified="false" />The specified <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" />.</param> <param name="line2"> @@ -430,7 +433,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method returns a string that contains details about the type, offset, priority, and filter values of the snapline.</para> @@ -439,6 +441,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a string representation of the current snapline.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" />.</para> + </returns> </Docs> </Member> </Members> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml index 97da8380bbd..909379e6909 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml @@ -49,7 +49,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A service provider is provided so that any required editing services can be obtained.</para> @@ -58,6 +57,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the value of the specified object using the specified service provider and context.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -80,12 +83,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editor style used by the <see cref="M:System.Windows.Forms.Design.AnchorEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values indicating the provided editing style. If the method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml index d20488494ee..fa4c39872c3 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml @@ -104,12 +104,15 @@ <Parameter Name="file" Type="System.IO.FileInfo" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a wrapper for an ActiveX control for use in the design-time environment.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An assembly qualified name for the type of ActiveX control for which a wrapper was generated.</para> + </returns> <param name="file"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.FileInfo" /> indicating the file that contains the control. </param> </Docs> @@ -128,12 +131,15 @@ <Parameter Name="typeLib" Type="System.Runtime.InteropServices.UCOMITypeLib" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a wrapper for an ActiveX control for use in the design-time environment.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An assembly qualified name for the type of ActiveX control for which a wrapper was generated.</para> + </returns> <param name="typeLib"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.UCOMITypeLib" /> that indicates the type library to generate the control from. </param> </Docs> @@ -153,12 +159,15 @@ <Parameter Name="clsid" Type="System.Guid" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Generates a wrapper for an ActiveX control for use in the design-time environment.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An assembly qualified name for the type of ActiveX control for which a wrapper was generated.</para> + </returns> <param name="typeLib"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.UCOMITypeLib" /> that indicates the type library to generate the control from. </param> <param name="clsid"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml index a99223a341f..9bb24a05174 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml @@ -117,12 +117,15 @@ <Parameter Name="infos" Type="System.Reflection.ParameterInfo[]" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified parameter information to an <see cref="T:System.Windows.Forms.Design.AxParameterData" /> object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Windows.Forms.Design.AxParameterData" /> objects representing the specified array of <see cref="T:System.Reflection.ParameterInfo" /> objects.</para> + </returns> <param name="infos"> <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Reflection.ParameterInfo" /> objects to convert. </param> </Docs> @@ -142,12 +145,15 @@ <Parameter Name="ignoreByRefs" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Converts the specified parameter information to an <see cref="T:System.Windows.Forms.Design.AxParameterData" /> object, according to the specified value indicating whether to ignore by reference parameters.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Windows.Forms.Design.AxParameterData" /> objects representing the specified array of <see cref="T:System.Reflection.ParameterInfo" /> objects.</para> + </returns> <param name="infos"> <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Reflection.ParameterInfo" /> objects to convert. </param> <param name="ignoreByRefs"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml index e170479883f..f9163cf6180 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml @@ -47,12 +47,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the given object value using the editor style provided by <see cref="M:System.Windows.Forms.Design.BorderSidesEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The edited object.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing information about the control or component.</param> <param name="provider"> @@ -74,12 +77,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the editing style of the EditValue method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values. If the method is not supported, this method returns <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing information about the control or component.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml index 1c72b271363..ce75f6b9f28 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml @@ -111,7 +111,6 @@ <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If a tool is supported, it will be enabled in the toolbox when the designer regains focus. Otherwise, it will be disabled. Once a tool is marked as enabled or disabled it cannot be queried again.</para> @@ -120,6 +119,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified tool is supported by the designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the tool should be enabled on the toolbox; false if the document designer doesn't know how to use the tool.</para> + </returns> <param name="tool"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to test for toolbox support. </param> </Docs> @@ -191,7 +194,6 @@ <Parameter Name="technology" Type="System.ComponentModel.Design.ViewTechnology" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para> @@ -200,6 +202,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="T:System.ComponentModel.Design.ViewTechnology" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that represents the view for this designer.</para> + </returns> <param name="technology"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> that indicates a particular view technology.</param> </Docs> @@ -241,7 +247,6 @@ <Parameter Name="attributes" Type="System.Collections.IDictionary" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" /> interface.</para> @@ -250,6 +255,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.ITypeDescriptorFilterService.FilterAttributes(System.ComponentModel.IComponent,System.Collections.IDictionary)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the set of filtered attributes is to be cached; false if the filter service must query again.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to filter the attributes of.</param> <param name="attributes"> @@ -271,7 +280,6 @@ <Parameter Name="events" Type="System.Collections.IDictionary" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" /> interface.</para> @@ -280,6 +288,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.ITypeDescriptorFilterService.FilterEvents(System.ComponentModel.IComponent,System.Collections.IDictionary)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the set of filtered events is to be cached; false if the filter service must query again.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to filter events for.</param> <param name="events"> @@ -301,7 +313,6 @@ <Parameter Name="properties" Type="System.Collections.IDictionary" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" /> interface.</para> @@ -310,6 +321,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.ITypeDescriptorFilterService.FilterProperties(System.ComponentModel.IComponent,System.Collections.IDictionary)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the set of filtered properties is to be cached; false if the filter service must query again.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to filter properties for.</param> <param name="properties"> @@ -330,7 +345,6 @@ <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.Drawing.Design.IToolboxUser" /> interface.</para> @@ -339,6 +353,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Drawing.Design.IToolboxUser.GetToolSupported(System.Drawing.Design.ToolboxItem)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the tool is supported by the toolbox and can be enabled; false if the document designer does not know how to use the tool.</para> + </returns> <param name="tool"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to be tested for toolbox support.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml index 463e7babb8b..4199ab1b0ec 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml @@ -116,12 +116,15 @@ <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified tool can be used to create a new component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the specified tool can be used to create a component; otherwise, false.</para> + </returns> <param name="tool"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to test. </param> </Docs> @@ -140,7 +143,6 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method tests the specified component for the existence of a <see cref="T:System.ComponentModel.DesignTimeVisibleAttribute" />, which indicates whether the component has a user interface that can be displayed.</para> @@ -149,6 +151,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether the specified component can be displayed.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the component can be displayed; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to test. </param> </Docs> @@ -262,7 +268,6 @@ <Parameter Name="receiver" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para> @@ -272,6 +277,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the location of the specified component, relative to the upper-left corner of the component tray.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Point" /> indicating the coordinates of the specified component, or an empty <see cref="T:System.Drawing.Point" /> if the specified component could not be found in the component tray. An empty <see cref="T:System.Drawing.Point" /> has an <see cref="P:System.Drawing.Point.IsEmpty" /> property equal to true and typically has <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> properties that are each equal to zero.</para> + </returns> <param name="receiver"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to retrieve the location of. </param> </Docs> @@ -311,12 +320,15 @@ <Parameter Name="forward" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Similar to <see cref="M:System.Windows.Forms.Control.GetNextControl(System.Windows.Forms.Control,System.Boolean)" />, this method returns the next component in the tray, given a starting component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The next component in the component tray, or null, if the end of the list is encountered (or the beginning, if <paramref name="forward" /> is false).</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component from which to start enumerating.</param> <param name="forward"> @@ -334,12 +346,15 @@ </Parameters> <Docs> <param name="service">To be added.</param> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the requested service type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the requested service, or null if the service could not be found.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -373,7 +388,6 @@ <Parameter Name="receiver" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The Location extender property is offered to all non-visual components. The returned value takes into account the value of <see cref="P:System.Windows.Forms.ScrollableControl.AutoScrollPosition" />. If <paramref name="receiver" /> does not have a component view, the returned value is an empty <see cref="T:System.Drawing.Point" />.</para> @@ -382,6 +396,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the value of the Location extender property.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Point" /> representing the location of <paramref name="receiver" />. </para> + </returns> <param name="receiver"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> that receives the location extender property.</param> </Docs> @@ -399,12 +417,15 @@ <Parameter Name="comp" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Tests a component for presence in the component tray.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="comp" /> is being shown on the tray; otherwise, false.</para> + </returns> <param name="comp"> <attribution license="cc4" from="Microsoft" modified="false" />The component to test for presence in the component tray.</param> </Docs> @@ -827,7 +848,6 @@ <Parameter Name="component" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.ComponentTray" /> instance is cast to an <see cref="T:System.ComponentModel.IExtenderProvider" /> interface.</para> @@ -836,6 +856,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.ComponentModel.IExtenderProvider.CanExtend(System.Object)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if this object can provide extender properties to the specified object; otherwise, false.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to receive the extender properties.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml index 16451f75d7d..f838d4e85a4 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml @@ -175,7 +175,6 @@ <Parameter Name="parentDesigner" Type="System.ComponentModel.Design.IDesigner" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method is useful for testing whether a control can be parented by a particular type of parent. For example, <see cref="T:System.Windows.Forms.TabPage" /> controls can only be parented by <see cref="T:System.Windows.Forms.TabControl" /> controls.</para> @@ -187,6 +186,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates if this designer's control can be parented by the control of the specified designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the control managed by the specified designer can parent the control managed by this designer; otherwise, false.</para> + </returns> <param name="parentDesigner"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesigner" /> that manages the control to check. </param> </Docs> @@ -297,7 +300,6 @@ <Parameter Name="name" Type="System.String" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The child control specified by <paramref name="child" /> is a child of this control designer's control. The child does not directly participate in persistence, but it will if it is exposed as a property of the main control. Consider a control like the <see cref="T:System.Windows.Forms.SplitContainer" />: it has two panels, Panel1 and Panel2. These panels are exposed through read only <see cref="P:System.Windows.Forms.SplitContainer.Panel1" /> and <see cref="P:System.Windows.Forms.SplitContainer.Panel2" /> properties on the <see cref="T:System.Windows.Forms.SplitContainer" /> control. The <see cref="T:System.Windows.Forms.SplitContainer" /> control's designer calls <see cref="M:System.Windows.Forms.Design.ControlDesigner.EnableDesignMode(System.Windows.Forms.Control,System.String)" /> for each panel, which allows other components to be dropped on them. But, in order for the contents of <see cref="P:System.Windows.Forms.SplitContainer.Panel1" /> and <see cref="P:System.Windows.Forms.SplitContainer.Panel2" /> to be saved, the <see cref="T:System.Windows.Forms.SplitContainer" /> control itself must expose the panels as public properties.</para> @@ -308,6 +310,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Enables design time functionality for a child control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the child control could be enabled for design time; false if the hosting infrastructure does not support it.</para> + </returns> <param name="child"> <attribution license="cc4" from="Microsoft" modified="false" />The child control for which design mode will be enabled.</param> <param name="name"> @@ -372,12 +378,15 @@ <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a <see cref="T:System.Windows.Forms.Design.Behavior.ControlBodyGlyph" /> representing the bounds of this control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Windows.Forms.Design.Behavior.ControlBodyGlyph" /> representing the bounds of this control.</para> + </returns> <param name="selectionType"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param> </Docs> @@ -395,7 +404,6 @@ <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Note that based on <paramref name="selectionType" />, the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects returned will represent one of these selection states:</para> @@ -415,6 +423,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects representing the selection borders and grab handles for a standard control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para> + </returns> <param name="selectionType"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param> </Docs> @@ -429,7 +441,6 @@ <Parameter Name="point" Type="System.Drawing.Point" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.ControlDesigner.GetHitTest(System.Drawing.Point)" /> method determines whether a click at the specified point should be passed to the control, while the control is in design mode. You can override and implement this method to enable your control to receive clicks in the design-time environment.</para> @@ -442,6 +453,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether a mouse click at the specified point should be handled by the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if a click at the specified point is to be handled by the control; otherwise, false.</para> + </returns> <param name="point"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> indicating the position at which the mouse was clicked, in screen coordinates. </param> </Docs> @@ -580,7 +595,6 @@ <Parameter Name="internalControlIndex" Type="System.Int32" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>An internal control is a control that is not in the <see cref="P:System.ComponentModel.IContainer.Components" /> collection of the <see cref="P:System.ComponentModel.Design.IDesignerHost.Container" />. <see cref="T:System.Windows.Forms.SplitterPanel" /> is an example of one such control.</para> @@ -589,6 +603,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the internal control designer with the specified index in the <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Windows.Forms.Design.ControlDesigner" /> at the specified index.</para> + </returns> <param name="internalControlIndex"> <attribution license="cc4" from="Microsoft" modified="false" />A specified index to select the internal control designer. This index is zero-based.</param> </Docs> @@ -626,7 +644,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>An internal control is a control that is not in the <see cref="P:System.ComponentModel.IContainer.Components" /> collection of the <see cref="P:System.ComponentModel.Design.IDesignerHost.Container" />. <see cref="T:System.Windows.Forms.SplitterPanel" /> is an example of one such control.</para> @@ -635,6 +652,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns the number of internal control designers in the <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The number of internal control designers in the <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para> + </returns> </Docs> </Member> <Member MemberName="OnContextMenu"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml index 33a7df14059..5c7c5987f3f 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml @@ -46,12 +46,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified object value using the editor style provided by GetEditorStyle. A service provider is provided so that any required editing services can be obtained.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -74,12 +77,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Retrieves the editing style of the EditValue method. If the method is not supported, this will return None.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An enum value indicating the provided editing style.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml index 66d07c0f97f..946799ff40a 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml @@ -107,12 +107,15 @@ <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" /> representing the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para> + </returns> <param name="selectionType"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param> </Docs> @@ -127,7 +130,6 @@ <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If a tool is supported, it will be enabled in the toolbox when the designer receives focus. Otherwise, it will be disabled. Once a tool is marked as enabled or disabled it can not be queried again.</para> @@ -136,6 +138,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the specified tool is supported by the designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the tool should be enabled on the toolbox; false if the document designer doesn't know how to use the tool.</para> + </returns> <param name="tool"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to test for toolbox support. </param> </Docs> @@ -310,7 +316,6 @@ <Parameter Name="technology" Type="System.ComponentModel.Design.ViewTechnology" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.DocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para> @@ -319,6 +324,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="T:System.ComponentModel.Design.ViewTechnology" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An object that represents the view for this designer.</para> + </returns> <param name="technology"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> that indicates a particular view technology.</param> </Docs> @@ -359,7 +368,6 @@ <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" /> </Parameters> <Docs> - <returns>To be added.</returns> <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.Windows.Forms.Design.DocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para> @@ -368,6 +376,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>For a description of this member, see <see cref="M:System.Drawing.Design.IToolboxUser.GetToolSupported(System.Drawing.Design.ToolboxItem)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the tool is supported by the toolbox and can be enabled; false if the document designer does not know how to use the tool.</para> + </returns> <param name="tool"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to be tested for toolbox support.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml index 865323057ff..74df61e6fc0 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml @@ -93,7 +93,6 @@ <Parameter Name="handlerType" Type="System.Type" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>You should never cache this value because other components are free to change it. This call is fairly quick, however, especially for cases when you are always asking for the same type of handler.</para> @@ -102,6 +101,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the currently active event handler of the specified type.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An instance of the handler, or null if there is no handler of the requested type.</para> + </returns> <param name="handlerType"> <attribution license="cc4" from="Microsoft" modified="false" />The type of the handler to get. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml index 7c79f07d4e6..e5741f42cdb 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml @@ -50,7 +50,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>A service provider is provided so that any required editing services can be obtained.</para> @@ -59,6 +58,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified object using the editor style provided by the <see cref="M:System.Windows.Forms.Design.FileNameEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -81,7 +84,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <see cref="M:System.Windows.Forms.Design.FileNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para> @@ -90,6 +92,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editing style used by the <see cref="M:System.Windows.Forms.Design.FileNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values indicating the provided editing style.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml index 8eff80bca5f..c3f2af411ee 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml @@ -49,12 +49,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified object using the editor style provided by <see cref="M:System.Windows.Forms.Design.FolderNameEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the object, or the old value if the object couldn't be updated.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -77,7 +80,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the <see cref="M:System.Windows.Forms.Design.FolderNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method is not supported, this will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para> @@ -86,6 +88,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editing style used by the <see cref="M:System.Windows.Forms.Design.FolderNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the provided editing style.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml index 0adf90a2d15..b82a72540bd 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml @@ -26,12 +26,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the current menu.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The current <see cref="T:System.Windows.Forms.Menu" />.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -46,12 +49,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the current menu is active.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the current menu is currently active; otherwise, false.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml index 9e2e5b3b223..0e73ad21332 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml @@ -46,7 +46,6 @@ <Parameter Name="codeObject" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.ImageListCodeDomSerializer.Deserialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method uses the serialization manager to create objects and resolve data types.</para> @@ -55,6 +54,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Deserializes the specified serialized Code Document Object Model (CodeDOM) object into an object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The deserialized CodeDOM object.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />A serialization manager interface that is used during the deserialization process.</param> <param name="codeObject"> @@ -75,12 +78,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Serializes the specified object into a Code Document Object Model (CodeDOM) object.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A CodeDOM object representing the object that has been serialized.</para> + </returns> <param name="manager"> <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use during serialization.</param> <param name="value"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml index 0867a0736ce..6c1a103fbbf 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml @@ -47,7 +47,6 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This editor uses a service provider to obtain any necessary editing services.</para> @@ -56,6 +55,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the specified object value using the edit style provided by the <see cref="M:System.Drawing.Design.ImageEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An <see cref="T:System.Object" /> representing the new value. If the value of the object has not changed, the <see cref="M:System.Windows.Forms.Design.ImageListImageEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method returns the object that was passed to it.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param> <param name="provider"> @@ -75,7 +78,6 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The file dialog box description appears in the file-list filter drop-down list box.</para> @@ -84,6 +86,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the description for the default file-list filter provided by this editor.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The description for the default file-list filter.</para> + </returns> </Docs> </Member> <Member MemberName="GetImageExtenders"> @@ -97,12 +103,15 @@ </ReturnValue> <Parameters /> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets an array of supported image types.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of <see cref="T:System.Type" /> representing supported image types.</para> + </returns> </Docs> </Member> <Member MemberName="GetPaintValueSupported"> @@ -118,12 +127,15 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a value indicating whether this editor supports painting a representation of an object's value.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <see cref="M:System.Drawing.Design.ImageEditor.PaintValue(System.Drawing.Design.PaintValueEventArgs)" /> is implemented; otherwise, false.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml index 3ff2771d1b1..97cc98b26c5 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml @@ -71,7 +71,6 @@ <Parameter Name="maskDescriptor" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.MaskDescriptor.Equals(System.Object)" /> method determines whether <paramref name="maskDescriptor" /> and the current mask descriptor describe the same mask.</para> @@ -86,6 +85,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Determines whether the specified <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> is equal to the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the specified <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> is equal to the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />; otherwise, false. </para> + </returns> <param name="maskDescriptor"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> to compare with the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />.</param> </Docs> @@ -119,7 +122,6 @@ <Parameter Name="maskDescriptor" Type="System.Windows.Forms.Design.MaskDescriptor" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.MaskDescriptor.IsValidMaskDescriptor(System.Windows.Forms.Design.MaskDescriptor)" /> method determines whether <paramref name="maskDescriptor" /> is valid and can be added to the masks list.</para> @@ -149,6 +151,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Returns a value indicating whether the specified mask descriptor is valid and can be added to the masks list.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if <paramref name="maskDescriptor" /> is valid; otherwise, false. </para> + </returns> <param name="maskDescriptor"> <attribution license="cc4" from="Microsoft" modified="false" />The mask descriptor to test for validity.</param> </Docs> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml index 623cbbf6d5f..b4b8a89c1f0 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml @@ -128,7 +128,6 @@ <Parameter Name="control" Type="System.Windows.Forms.Control" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method indicates whether the control managed by the designer can parent the specified <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para> @@ -137,6 +136,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the specified control can be a child of the control managed by this designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the specified control can be a child of the control managed by this designer; otherwise, false.</para> + </returns> <param name="control"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to test. </param> </Docs> @@ -156,7 +159,6 @@ </Parameters> <Docs> <param name="designer">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method indicates whether the control managed by this designer can parent the control of the specified <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para> @@ -165,6 +167,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether the control managed by the specified designer can be a child of the control managed by this designer.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if the control managed by the specified designer can be a child of the control managed by this designer; otherwise, false.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> @@ -273,7 +279,6 @@ <Parameter Name="hasSize" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This is the only <see cref="Overload:System.Windows.Forms.Design.ParentControlDesigner.CreateTool" /> method that can be overridden.</para> @@ -282,6 +287,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Provides core functionality for all the <see cref="M:System.Windows.Forms.Design.ParentControlDesigner.CreateTool(System.Drawing.Design.ToolboxItem)" /> methods.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>An array of components created from the tool.</para> + </returns> <param name="tool"> <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to create a component from. </param> <param name="x"> @@ -399,12 +408,15 @@ <Parameter Name="component" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the control from the designer of the specified component.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The <see cref="T:System.Windows.Forms.Control" /> that the specified component belongs to.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the control for. </param> </Docs> @@ -426,7 +438,6 @@ <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <newTerm>body glyph</newTerm> is responsible for hit testing the control's designer and forwarding messages directly to the designer.</para> @@ -435,6 +446,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a body glyph that represents the bounds of the control. </para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A body glyph that represents the bounds of the control.</para> + </returns> <param name="selectionType"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param> </Docs> @@ -452,7 +467,6 @@ <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.ParentControlDesigner.GetGlyphs(System.Windows.Forms.Design.Behavior.GlyphSelectionType)" /> method adds a container selector <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to the selection glyphs collection.</para> @@ -461,6 +475,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets a collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects representing the selection borders and grab handles for a standard control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para> + </returns> <param name="selectionType"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param> </Docs> @@ -478,12 +496,15 @@ <Parameter Name="component" Type="System.ComponentModel.IComponent" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Used by deriving classes to determine if it returns the control being designed or some other <see cref="T:System.ComponentModel.Container" /> while adding a component to it.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The parent <see cref="T:System.Windows.Forms.Control" /> for the component.</para> + </returns> <param name="component"> <attribution license="cc4" from="Microsoft" modified="false" />The component for which to retrieve the parent <see cref="T:System.Windows.Forms.Control" />.</param> </Docs> @@ -500,7 +521,6 @@ <Parameter Name="updateSize" Type="System.Boolean" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>This method aligns the specified rectangle to the grid if grid alignment is enabled.</para> @@ -509,6 +529,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Updates the position of the specified rectangle, adjusting it for grid alignment if grid alignment mode is enabled.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A rectangle indicating the position of the component in design-time view screen coordinates. If no changes have been made, this method returns the original rectangle.</para> + </returns> <param name="originalRect"> <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> indicating the initial position of the component being updated. </param> <param name="dragRect"> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml index 71ec4e5a177..230e56203b0 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml @@ -53,7 +53,6 @@ </Parameters> <Docs> <param name="point">To be added.</param> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>The <see cref="M:System.Windows.Forms.Design.ScrollableControlDesigner.GetHitTest(System.Drawing.Point)" /> method determines whether a click at the specified point should be passed to the control, while the control is in design mode. You can override and implement this method to enable your control to receive clicks in the design-time environment.</para> @@ -65,6 +64,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Indicates whether a mouse click at the specified point should be handled by the control.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>true if a click at the specified point is to be handled by the control; otherwise, false.</para> + </returns> </Docs> <AssemblyInfo> <AssemblyVersion>1.0.5000.0</AssemblyVersion> diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml index 9693924c722..d11b867a194 100644 --- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml +++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml @@ -47,12 +47,15 @@ <Parameter Name="value" Type="System.Object" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks>To be added.</remarks> <summary> <attribution license="cc4" from="Microsoft" modified="false" /> <para>Edits the given object value using the editor style provided by the <see cref="M:System.Windows.Forms.Design.ShortcutKeysEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>The new value of the <see cref="T:System.Object" />.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param> <param name="provider"> @@ -74,7 +77,6 @@ <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" /> </Parameters> <Docs> - <returns>To be added.</returns> <remarks> <attribution license="cc4" from="Microsoft" modified="false" /> <para>If the method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para> @@ -83,6 +85,10 @@ <attribution license="cc4" from="Microsoft" modified="false" /> <para>Gets the editor style used by the <see cref="Overload:System.Windows.Forms.Design.ShortcutKeysEditor.EditValue" /> method.</para> </summary> + <returns> + <attribution license="cc4" from="Microsoft" modified="false" /> + <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the style of editor used by the <see cref="Overload:System.Windows.Forms.Design.ShortcutKeysEditor.EditValue" /> method.</para> + </returns> <param name="context"> <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param> </Docs> |