diff --git a/xml/System.Web.UI.WebControls.WebParts/PersonalizationScope.xml b/xml/System.Web.UI.WebControls.WebParts/PersonalizationScope.xml index afb05001358..b1313502f78 100644 --- a/xml/System.Web.UI.WebControls.WebParts/PersonalizationScope.xml +++ b/xml/System.Web.UI.WebControls.WebParts/PersonalizationScope.xml @@ -56,15 +56,7 @@ 1 - When referring to the scope on the control, scope means that personalization data applies to all users for all personalizable controls on a page and is also available to be saved on the page. - - - + When referring to the scope on the control, scope means that personalization data applies to all users for all personalizable controls on a page and is also available to be saved on the page.
When referring to the scope associated with a Web Parts control property, scope indicates that the property normally only allows loading or saving of data associated with all users. @@ -85,15 +77,7 @@ 0 - When referring to the scope on the control, scope means that personalization data that is user-specific, as well as personalization data that applies to all users, is loaded for all personalizable controls on a page. Only personalization data that is user-specific can be saved on the page. - - - + When referring to the scope on the control, scope means that personalization data that is user-specific, as well as personalization data that applies to all users, is loaded for all personalizable controls on a page. Only personalization data that is user-specific can be saved on the page.
When referring to the scope associated with a Web Parts control property, scope indicates that the property can only load and store data applicable to all users when running on a page in scope. However, when the property's control is running on a page in scope, the property's per-user and all-user data will be loaded and merged. In this case, though, only per-user data will be saved when a page is running in scope scope. diff --git a/xml/System.Web.UI.WebControls/DataControlRowState.xml b/xml/System.Web.UI.WebControls/DataControlRowState.xml index 119e34920df..b757cca885d 100644 --- a/xml/System.Web.UI.WebControls/DataControlRowState.xml +++ b/xml/System.Web.UI.WebControls/DataControlRowState.xml @@ -61,15 +61,8 @@ 1 - Indicates that the data control row is an alternate row. - - - + Indicates that the data control row is an alternate row. + The state can be combined with other states, such as , , or , at any time. These rows might be affected by the property of the data control, if set. @@ -157,4 +150,4 @@ - \ No newline at end of file + diff --git a/xml/System.Web.UI.WebControls/RepeatLayout.xml b/xml/System.Web.UI.WebControls/RepeatLayout.xml index 07d2c04b724..9f95e6fd48f 100644 --- a/xml/System.Web.UI.WebControls/RepeatLayout.xml +++ b/xml/System.Web.UI.WebControls/RepeatLayout.xml @@ -19,15 +19,106 @@ enumeration represents the different layout options for a list control. +## Remarks + +The enumeration represents the different layout options for a list control. - +## Examples + +The following example shows a list control whose layout is defined by the `Table` enumeration value. -## Examples - [!code-aspx-csharp[DataListLayout#1](~/samples/snippets/csharp/VS_Snippets_WebNet/DataListLayout/CS/datalistlayoutcs.aspx#1)] - [!code-aspx-vb[DataListLayout#1](~/samples/snippets/visualbasic/VS_Snippets_WebNet/DataListLayout/VB/datalistlayoutvb.aspx#1)] +[!code-aspx-csharp[DataListLayout#1](~/samples/snippets/csharp/VS_Snippets_WebNet/DataListLayout/CS/datalistlayoutcs.aspx#1)] +[!code-aspx-vb[DataListLayout#1](~/samples/snippets/visualbasic/VS_Snippets_WebNet/DataListLayout/VB/datalistlayoutvb.aspx#1)] + +The following example shows markup that is rendered for a control whose property is set to `Flow`. +```xaml + + + +
+ + +
+ + + +``` + +The following example shows markup that is rendered for a control whose property is set to `OrderedList`. + +```xaml +
    +
  1. + + +
    2. +
  2. + + +
    3. +
  3. + + +
    4. +
+``` + +The following example shows markup that is rendered for a control whose property is set to `Table`. + +```xaml + + + + + + + + + + +
+ + +
+ + +
+ + +
+``` +The following example shows markup that is rendered for a control whose property is set to `UnorderedList`. + +```xaml +
    +
  • + + +
    • +
  • + + +
    • +
  • + + +
    • +
+``` + ]]> @@ -61,30 +152,6 @@ 1 Items are displayed without a table structure. Rendered markup consists of a element and items are separated by elements. - - control whose property is set to Flow. - -``` - - - -
- - -
- - - -``` - - ]]> - @@ -104,38 +171,7 @@ 3 - Items are displayed without a table structure. Rendered markup consists of an element that contains elements. - - control whose property is set to OrderedList. - -``` -
    -
  1. - - -
    2. -
  2. - - -
    3. -
  3. - - -
    4. -
-``` - -> [!NOTE] -> This field is new as of ASP.NET 4 and is a valid option only for the and controls. - - ]]> - + Items are displayed without a table structure. Rendered markup consists of an element that contains elements.
This value is new as of ASP.NET 4 and is a valid option only for the and controls. @@ -157,44 +193,7 @@ 0 - Items are displayed in a table. - - control whose property is set to Table. - -> [!NOTE] -> This option causes the control to render HTML that might not conform to accessibility standards. For more information, see [Accessibility in Visual Studio and ASP.NET](https://msdn.microsoft.com/library/7e3ce9c4-6b7d-4fb1-94b5-72cf2a44fe13). - -``` - - - - - - - - - - -
- - -
- - -
- - -
-``` - - ]]> - + Items are displayed in a table.
This option causes the control to render HTML that might not conform to accessibility standards. For more information, see Accessibility in Visual Studio and ASP.NET. @@ -214,39 +213,8 @@ 2 - Items are displayed without a table structure. Rendered markup consists of a element that contains elements. - - control whose property is set to UnorderedList. - -``` -
    -
  • - - -
    • -
  • - - -
    • -
  • - - -
    • -
-``` - -> [!NOTE] -> This field is new as of ASP.NET 4 and is a valid option only for the and controls. - - ]]> - + Items are displayed without a table structure. Rendered markup consists of a element that contains elements.
This field is new as of ASP.NET 4 and is a valid option only for the and controls. - \ No newline at end of file + diff --git a/xml/System.Web.Util/RequestValidationSource.xml b/xml/System.Web.Util/RequestValidationSource.xml index 841e6394afd..b6d4861b4b3 100644 --- a/xml/System.Web.Util/RequestValidationSource.xml +++ b/xml/System.Web.Util/RequestValidationSource.xml @@ -17,25 +17,33 @@ type. When ASP.NET calls the method to validate a request, ASP.NET passes a `requestValidationSource` parameter to specify the source of the data being validated. The enumeration is used to specify the source or kind of request data that is being validated. The enumeration indicates the type of HTTP input that is passed in the `value` parameter of the method. You can use the enumeration as a way to fall back to the base request validation implementation for HTTP inputs if you do not want to validate using custom logic. - - +## Remarks + +You can create a custom request validation type by implementing the type. When ASP.NET calls the method to validate a request, ASP.NET passes a `requestValidationSource` parameter to specify the source of the data being validated. The enumeration is used to specify the source or kind of request data that is being validated. The enumeration indicates the type of HTTP input that is passed in the `value` parameter of the method. You can use the enumeration as a way to fall back to the base request validation implementation for HTTP inputs if you do not want to validate using custom logic. + +The following table shows how the value of the `collectionKey` and `value` parameter of the method are interpreted for each member of the `RequestValidationSource` enumeration. + +|Enumeration member|`collectionKey` parameter|`value` parameter| +|--|--|--| +|`Cookies`|The name of the cookie in the collection.|The value in the collection.| +|`Files`|The name of the uploaded file in the collection.|The value of the uploaded file in the collection.| +|`Form`|The name of the form parameter in the collection|The value of the form parameter in the collection.| +|`Headers`|The name of an HTTP header in the collection.|The value of the HTTP header in the collection.| +|`Path`|`null` (`Path` is not a collection of values).|The value of the Path field.| +|`PathInfo`|`null` (`PathInfo` is not a collection of values).|The value of the PathInfo field.| +|`QueryString`|The name of the query-string parameter in the collection.|The value of the query-string parameter in the collection.| +|`RawUrl`|`null` (`RawUrl` is not a collection of values.)|The value of the RawUrl field.| ## Examples The following example shows how to create a custom request validator class that allows only a specific string for query-string values. -```vb -Imports System +```vb Imports System.Web Imports System.Web.Util Public Class CustomRequestValidation Inherits RequestValidator -Public Sub New() -End Sub - Protected Overloads Overrides Function IsValidRequestString( _ ByVal context As HttpContext, _ ByVal value As String, _ @@ -156,16 +164,6 @@ public class CustomRequestValidation : RequestValidator 2 The request cookies. - - method is set to the name of the cookie in the collection. - - The `value` parameter of the method is set to the value in the collection. - - ]]> - @@ -186,16 +184,6 @@ public class CustomRequestValidation : RequestValidator 3 The uploaded file. - - method is set to the name of the uploaded file in the collection. - - The `value` parameter of the method is set to the value of the uploaded file in the collection. - - ]]> - @@ -216,16 +204,6 @@ public class CustomRequestValidation : RequestValidator 1 The form values. - - method is set to the name of the form parameter in the collection. - - The `value` parameter of the method is set to the value of the form parameter in the collection. - - ]]> - @@ -246,16 +224,6 @@ public class CustomRequestValidation : RequestValidator 7 The request headers. - - method is set to the name of an HTTP header in the collection. - - The `value` parameter of the method is set to the value of the HTTP header in the collection. - - ]]> - @@ -276,16 +244,6 @@ public class CustomRequestValidation : RequestValidator 5 The virtual path. - - method is set to `null` (`Path` is not a collection of values). - - The `value` parameter of the method is set to the value of the Path field. - - ]]> - @@ -306,16 +264,6 @@ public class CustomRequestValidation : RequestValidator 6 An HTTP string, which is an extension to a URL path. - - method is set to `null` (`PathInfo` is not a collection of values). - - The `value` parameter of the method is set to the value of the PathInfo field. - - ]]> - @@ -336,16 +284,6 @@ public class CustomRequestValidation : RequestValidator 0 The query string. - - method is set to the name of the query string parameter in the collection. - - The `value` parameter of the method is set to the value of the query-string parameter in the collection. - - ]]> - @@ -366,16 +304,6 @@ public class CustomRequestValidation : RequestValidator 4 The raw URL. (The part of a URL after the domain.) - - method is set to `null`. (`RawUrl` is not a collection of values.) - - The `value` parameter of the method is set to the value of the RawUrl field. - - ]]> - diff --git a/xml/System.Windows.Controls/GridResizeBehavior.xml b/xml/System.Windows.Controls/GridResizeBehavior.xml index 5babca7ea42..83228d7f6b3 100644 --- a/xml/System.Windows.Controls/GridResizeBehavior.xml +++ b/xml/System.Windows.Controls/GridResizeBehavior.xml @@ -19,7 +19,30 @@ property of a . + +This enumeration is used to set the value of the property. + +The behavior of the property with the `BasedOnAlignment` enumeration value is determined as follows: + +- If the value of the property specifies that space is redistributed between rows, the redistribution follows these guidelines: + + - When the property is set to , space is redistributed between the row that is specified for the and the row that is above that row. + + - When the property is set to , space is redistributed between the row that is specified for the and the row that is below that row. + + - When the property is set to , space is redistributed between the row that is above and the row that is below the row that is specified for the . + + - When the property is set to , space is redistributed between the row that is above and the row that is below the row that is specified for the . + +- If the value of the property specifies that space is redistributed between columns, the redistribution follows these guidelines: + + - When the property is set to , space is redistributed between the column that is specified for the and the column that is to the left. + + - When the property is set to , space is redistributed between the column that is specified for the and the column that is to the right. + + - When the property is set to , space is redistributed between the columns that are to the left and right of the column that is specified for the . + + - When the property is set to , space is redistributed between the columns that are to the left and right of the column that is specified for the . ]]> @@ -48,32 +71,6 @@ 0 Space is redistributed based on the value of the and properties. - - property specifies that space is redistributed between rows, the redistribution follows these guidelines: - -- When the property is set to , space is redistributed between the row that is specified for the and the row that is above that row. - -- When the property is set to , space is redistributed between the row that is specified for the and the row that is below that row. - -- When the property is set to , space is redistributed between the row that is above and the row that is below the row that is specified for the . - -- When the property is set to , space is redistributed between the row that is above and the row that is below the row that is specified for the . - - If the value of the property specifies that space is redistributed between columns, the redistribution follows these guidelines: - -- When the property is set to , space is redistributed between the column that is specified for the and the column that is to the left. - -- When the property is set to , space is redistributed between the column that is specified for the and the column that is to the right. - -- When the property is set to , space is redistributed between the columns that are to the left and right of the column that is specified for the . - -- When the property is set to , space is redistributed between the columns that are to the left and right of the column that is specified for the . - - ]]> - diff --git a/xml/System.Windows.Controls/GridResizeDirection.xml b/xml/System.Windows.Controls/GridResizeDirection.xml index 691b2cb5062..fa66cce6a08 100644 --- a/xml/System.Windows.Controls/GridResizeDirection.xml +++ b/xml/System.Windows.Controls/GridResizeDirection.xml @@ -18,8 +18,33 @@ property. + ## Remarks - Use this enumeration to set the property of the control. + +How the `Auto` enumeration value affects the redistribution of space in a control depends on the following property values: + +- If the property is not set to , space is redistributed between columns. + +- If the property is set to and the property is not set to , space is redistributed between rows. + +- If the following conditions are true, space is redistributed between columns: + + - The is set to . + + - The is set to . + + - The is less than or equal to the . + +- If the following conditions are true, space is redistributed between rows: + + - is set to . + + - is set to . + + - is greater than the . ]]> @@ -48,33 +73,6 @@ 0 Space is redistributed based on the values of the , , , and properties of the . - - is not set to , space is redistributed between columns. - -- If the is set to and the is not set to , space is redistributed between rows. - -- If the following conditions are true, space is redistributed between columns: - - - The is set to . - - - The is set to . - - - The is less than or equal to the . - -- If the following conditions are true, space is redistributed between rows: - - - is set to . - - - is set to . - - - is greater than the . - - ]]> - @@ -120,4 +118,4 @@ - \ No newline at end of file + diff --git a/xml/System.Windows.Data/UpdateSourceTrigger.xml b/xml/System.Windows.Data/UpdateSourceTrigger.xml index a0cc0128c24..2f31e76aa61 100644 --- a/xml/System.Windows.Data/UpdateSourceTrigger.xml +++ b/xml/System.Windows.Data/UpdateSourceTrigger.xml @@ -18,8 +18,11 @@ . +## Remarks + +A programmatic way to determine the default `UpdateSourceTrigger` value of a dependency property is to get the property metadata of the property using , and then to check the value of the property. + +For more information, see . ]]> @@ -46,14 +49,6 @@ 0 The default value of the binding target property. The default value for most dependency properties is , while the property has a default value of . - - value of a dependency property is to get the property metadata of the property using and then check the value of the property. - - ]]> - @@ -120,4 +115,4 @@ - \ No newline at end of file + diff --git a/xml/System.Windows.Forms/DataSourceUpdateMode.xml b/xml/System.Windows.Forms/DataSourceUpdateMode.xml index 0f508e2d654..1de0d3c8e30 100644 --- a/xml/System.Windows.Forms/DataSourceUpdateMode.xml +++ b/xml/System.Windows.Forms/DataSourceUpdateMode.xml @@ -90,15 +90,7 @@ 0 - Data source is updated when the control property is validated, - - - + Data source is updated when the control property is validated. After validation, the value in the control property is also reformatted. diff --git a/xml/System.Windows.Forms/ImeMode.xml b/xml/System.Windows.Forms/ImeMode.xml index 5c1836b60eb..465fb3bd70a 100644 --- a/xml/System.Windows.Forms/ImeMode.xml +++ b/xml/System.Windows.Forms/ImeMode.xml @@ -40,7 +40,7 @@ [!code-cpp[InputLanguageChanged#1](~/samples/snippets/cpp/VS_Snippets_Winforms/InputLanguageChanged/CPP/form1.cpp#1)] [!code-csharp[InputLanguageChanged#1](~/samples/snippets/csharp/VS_Snippets_Winforms/InputLanguageChanged/CS/form1.cs#1)] [!code-vb[InputLanguageChanged#1](~/samples/snippets/visualbasic/VS_Snippets_Winforms/InputLanguageChanged/VB/form1.vb#1)] - + ]]> @@ -267,18 +267,6 @@ 5 Katakana DBC. This setting is valid for the Japanese IME only. - - property to Katakana. - - [!code-cpp[InputLanguageChanged#1](~/samples/snippets/cpp/VS_Snippets_Winforms/InputLanguageChanged/CPP/form1.cpp#1)] - [!code-csharp[InputLanguageChanged#1](~/samples/snippets/csharp/VS_Snippets_Winforms/InputLanguageChanged/CS/form1.cs#1)] - [!code-vb[InputLanguageChanged#1](~/samples/snippets/visualbasic/VS_Snippets_Winforms/InputLanguageChanged/VB/form1.vb#1)] - - ]]> - diff --git a/xml/System.Windows.Forms/MessageBoxOptions.xml b/xml/System.Windows.Forms/MessageBoxOptions.xml index b18d531bbf1..0f0102fe817 100644 --- a/xml/System.Windows.Forms/MessageBoxOptions.xml +++ b/xml/System.Windows.Forms/MessageBoxOptions.xml @@ -25,14 +25,14 @@ class. - - If you do not want to specify this parameter when calling methods on , you can pass in 0 instead. - - - -## Examples - The following code example demonstrates how to display a with the options supported by this overload of . After verifying that a string variable, `ServerName`, is empty, the example displays a with a question box icon, offering the user the option to cancel the operation. The example uses the RightAlign member of the enumeration to align the text to the right edge of the dialog box. If the method's return value evaluates to [DialogResult.Yes](xref:System.Windows.Forms.DialogResult.Yes), the form that displayed the is closed. + +This enumeration is used by the class. + +If you do not want to specify an argument when calling methods on , you can pass in 0 instead. + +## Examples + +The following example demonstrates how to display a with the options supported by the overloads of that include an `options` parameter. After verifying that a string variable, `ServerName`, is empty, the example displays a with a question box icon, offering the user the option to cancel the operation. The example uses the `MessageBoxOptions.RightAlign` enumeration member to align the text to the right edge of the dialog box. If the method's return value evaluates to , the form that displayed the is closed. [!code-cpp[MessageBox.Show Variations#2](~/samples/snippets/cpp/VS_Snippets_Winforms/MessageBox.Show Variations/CPP/form1.cpp#2)] [!code-csharp[MessageBox.Show Variations#2](~/samples/snippets/csharp/VS_Snippets_Winforms/MessageBox.Show Variations/CS/form1.cs#2)] @@ -61,17 +61,7 @@ 131072 - The message box is displayed on the active desktop. - - to lose focus. The that is displayed will not use visual styles. For more information, see [Rendering Controls with Visual Styles](~/docs/framework/winforms/controls/rendering-controls-with-visual-styles.md). - - ]]> - + The message box is displayed on the active desktop. This constant is similar to `ServiceNotification`, except that the system displays the message box only on the default desktop of the interactive window station. The application that displayed the message box loses focus, and the message box is displayed without using visual styles. For more information, see Rendering Controls with Visual Styles. @@ -137,16 +127,8 @@ 2097152 - The message box is displayed on the active desktop. - - - + The message box is displayed on the active desktop. The caller is a service notifying the user of an event. displays a message box on the current active desktop, even if there is no user logged on to the computer. - \ No newline at end of file + diff --git a/xml/System.Workflow.ComponentModel/DependencyPropertyOptions.xml b/xml/System.Workflow.ComponentModel/DependencyPropertyOptions.xml index 6c3355513fe..69719f53705 100644 --- a/xml/System.Workflow.ComponentModel/DependencyPropertyOptions.xml +++ b/xml/System.Workflow.ComponentModel/DependencyPropertyOptions.xml @@ -116,15 +116,7 @@ 16 - The - - - + The is not serialized. diff --git a/xml/System.Workflow.Runtime/WorkflowStatus.xml b/xml/System.Workflow.Runtime/WorkflowStatus.xml index 00a0b7a63fd..04e603a2745 100644 --- a/xml/System.Workflow.Runtime/WorkflowStatus.xml +++ b/xml/System.Workflow.Runtime/WorkflowStatus.xml @@ -145,15 +145,7 @@ 3 - The workflow instance has been terminated by a - - activity, by a call to , or by the workflow runtime engine. - - ]]> - + The workflow instance has been terminated by a activity, by a call to , or by the workflow runtime engine.