diff --git a/xml/Microsoft.VisualBasic.Compatibility.VB6/WebBrowserArray.xml b/xml/Microsoft.VisualBasic.Compatibility.VB6/WebBrowserArray.xml index 896ebdd2d6f..abbf6fead87 100644 --- a/xml/Microsoft.VisualBasic.Compatibility.VB6/WebBrowserArray.xml +++ b/xml/Microsoft.VisualBasic.Compatibility.VB6/WebBrowserArray.xml @@ -817,8 +817,6 @@ MsgBox(CStr(WebBrowserArray(1).Text)) - -- - You can handle the `Navigating` event to cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. To cancel navigation, set the `Cancel` property of the object passed to the event handler to `true`. You can also use this object to retrieve the URL of the new document through the property. If the new document will be displayed in a Web page frame, you can retrieve the name of the frame through the property. Handle the event to receive notification when the control finishes navigation and has begun loading the document at the new location. Handle the event to receive notification when the control finishes loading the new document. @@ -826,7 +824,7 @@ MsgBox(CStr(WebBrowserArray(1).Text)) For more information about how to handle events, see [Handling and Raising Events](~/docs/standard/events/index.md). > [!NOTE] -> Functions and objects in the namespace are provided for use by the tools for upgrading from Visual Basic 6.0 to Visual Basic. In most cases, these functions and objects duplicate functionality that you can find in other namespaces in the [!INCLUDE[dnprdnshort](~/includes/dnprdnshort-md.md)]. They are necessary only when the Visual Basic 6.0 code model differs significantly from the [!INCLUDE[dnprdnshort](~/includes/dnprdnshort-md.md)] implementation. +> Functions and objects in the namespace are provided for use by the tools for upgrading from Visual Basic 6.0 to Visual Basic. In most cases, these functions and objects duplicate functionality that you can find in other namespaces in the [!INCLUDE[dnprdnshort](~/includes/dnprdnshort-md.md)]. They are necessary only when the Visual Basic 6.0 code model differs significantly from the [!INCLUDE[dnprdnshort](~/includes/dnprdnshort-md.md)] implementation. ]]> diff --git a/xml/System.Activities/WorkflowIdentityFilter.xml b/xml/System.Activities/WorkflowIdentityFilter.xml index 37dd3e3cc07..a0666070cb1 100644 --- a/xml/System.Activities/WorkflowIdentityFilter.xml +++ b/xml/System.Activities/WorkflowIdentityFilter.xml @@ -20,22 +20,22 @@ ## Remarks This class supports the versioning and dynamic update functionality of Windows Workflow Foundation. For more information about workflow versioning, workflow identity, and dynamic update, see the following topics: -- [Workflow Versioning](~/docs/framework/windows-workflow-foundation/whats-new-in-wf-in-dotnet.md) +- [Workflow Versioning](~/docs/framework/windows-workflow-foundation/whats-new-in-wf-in-dotnet.md) Describes the workflow versioning functionality introduced in [!INCLUDE[net_v45](~/includes/net-v45-md.md)]. - - [Dynamic Update](~/docs/framework/windows-workflow-foundation/dynamic-update.md) +- [Dynamic Update](~/docs/framework/windows-workflow-foundation/dynamic-update.md) Describes how to update the workflow definition of a persisted workflow instance by using dynamic update. - - [Using WorkflowApplication Identity and Versioning](~/docs/framework/windows-workflow-foundation/using-workflowidentity-and-versioning.md) +- [Using WorkflowApplication Identity and Versioning](~/docs/framework/windows-workflow-foundation/using-workflowidentity-and-versioning.md) Describes how to use to host multiple versions of a workflow side-by-side. - - [Side by Side Versioning in WorkflowServiceHost](~/docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md) +- [Side by Side Versioning in WorkflowServiceHost](~/docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md) Describes how to host multiple versions of a workflow on a single endpoint. - - [How to: Host Multiple Versions of a Workflow Side-by-Side](~/docs/framework/windows-workflow-foundation/how-to-host-multiple-versions-of-a-workflow-side-by-side.md) +- [How to: Host Multiple Versions of a Workflow Side-by-Side](~/docs/framework/windows-workflow-foundation/how-to-host-multiple-versions-of-a-workflow-side-by-side.md) This step in the [Getting Started Tutorial](~/docs/framework/windows-workflow-foundation/getting-started-tutorial.md) demonstrates updating a workflow definition, and hosting workflows using both the old and new definition at the same time. - - [How to: Update the Definition of a Running Workflow Instance](~/docs/framework/windows-workflow-foundation/how-to-update-the-definition-of-a-running-workflow-instance.md) +- [How to: Update the Definition of a Running Workflow Instance](~/docs/framework/windows-workflow-foundation/how-to-update-the-definition-of-a-running-workflow-instance.md) This step in the [Getting Started Tutorial](~/docs/framework/windows-workflow-foundation/getting-started-tutorial.md) demonstrates updating persisted workflow instances to use a new workflow definition. ]]> diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml index 01c2fdc2bce..cc1479b63a6 100644 --- a/xml/System.Net.Http/HttpClientHandler.xml +++ b/xml/System.Net.Http/HttpClientHandler.xml @@ -39,10 +39,12 @@ Starting with .NET Core 2.1, the loads an assembly by resolving the . This triggers a full resolution. The resolution fallback sequence follows this process: - 1. The method calls . - > [!IMPORTANT] - > must not call this method to prevent recursive stack overflow. - 2. Unless the assembly is loaded or an exception is thrown, the method attempts to load the assembly in the default . - 3. Unless the assembly is loaded or an exception is thrown, the method fires the event. - 4. Unless the assembly is loaded or an exception is thrown, the method fires the event. + + loads an assembly by resolving the . This triggers a full resolution. The resolution fallback sequence follows this process: + +1. The method calls . + + > [!IMPORTANT] + > must not call this method to prevent recursive stack overflow. + +2. Unless the assembly is loaded or an exception is thrown, the method attempts to load the assembly in the default . +3. Unless the assembly is loaded or an exception is thrown, the method fires the event. +4. Unless the assembly is loaded or an exception is thrown, the method fires the event. - > [!NOTE] - > is thrown if `assemblyRef` specifies the full assembly name, and the first assembly that matches the simple name has a incompatible version or culture. The loader does not continue probing for other assemblies that match the simple name. +> [!NOTE] +> is thrown if `assemblyRef` specifies the full assembly name, and the first assembly that matches the simple name has a incompatible version or culture. The loader does not continue probing for other assemblies that match the simple name. + +Each can load only: - Each can load only: - * One version of an executable assembly. - * One version of a satellite assembly for each culture. +* One version of an executable assembly. +* One version of a satellite assembly for each culture. ]]> diff --git a/xml/System.ServiceModel.Description/WsdlEndpointConversionContext.xml b/xml/System.ServiceModel.Description/WsdlEndpointConversionContext.xml index b30cadee1b4..481ee8cccda 100644 --- a/xml/System.ServiceModel.Description/WsdlEndpointConversionContext.xml +++ b/xml/System.ServiceModel.Description/WsdlEndpointConversionContext.xml @@ -20,7 +20,9 @@ class represents the context in which the custom WSDL for an endpoint is either exported using or imported using . The following properties enable you to retrieve the WSDL document object model for the current WSDL: + The class represents the context in which the custom WSDL for an endpoint is either exported using or imported using . + +The following properties enable you to retrieve the WSDL document object model for the current WSDL: - The property gets the for the endpoint contract. @@ -30,9 +32,7 @@ - The property gets the port for the current endpoint. -- - -- The following methods enable you to add or remove custom WSDL elements to the appropriate scopes in the exported or imported WSDL: +The following methods enable you to add or remove custom WSDL elements to the appropriate scopes in the exported or imported WSDL: - The method returns the fault binding for the specified fault. diff --git a/xml/System.Windows.Forms.DataVisualization.Charting/BorderSkinStyle.xml b/xml/System.Windows.Forms.DataVisualization.Charting/BorderSkinStyle.xml index ad66aeb45ce..f28e647aa87 100644 --- a/xml/System.Windows.Forms.DataVisualization.Charting/BorderSkinStyle.xml +++ b/xml/System.Windows.Forms.DataVisualization.Charting/BorderSkinStyle.xml @@ -18,12 +18,13 @@ class represents the style of the border skin used for a chart image. If you set the property to None, no skin will be used. This is the default value for the property. + +The class represents the style of the border skin used for a chart image. If you set the property to None, no skin will be used. This is the default value for the property. > [!NOTE] -> The difference between the sets of border skin styles that use frames and follow either the naming convention "FrameThin*" or "FrameTitle*" (for example, or ) is the shape and thickness of their frames. +> The difference between the sets of border skin styles that use frames and follow either the naming convention "FrameThin\*" or "FrameTitle\*" (for example, or ) is the shape and thickness of their frames. - In addition, if you use one of the "FrameThin" style border skins, the title of the chart will not be displayed. However, if you use one of the "FrameTitle" style border skins, the title of the chart will appear in the top-horizontal part of the frame. +In addition, if you use one of the "FrameThin" style border skins, the title of the chart will not be displayed. However, if you use one of the "FrameTitle" style border skins, the title of the chart will appear in the top-horizontal part of the frame. ]]> diff --git a/xml/System.Windows.Threading/DispatcherFrame.xml b/xml/System.Windows.Threading/DispatcherFrame.xml index eca19d63f13..c7b10cbdab3 100644 --- a/xml/System.Windows.Threading/DispatcherFrame.xml +++ b/xml/System.Windows.Threading/DispatcherFrame.xml @@ -99,15 +99,14 @@ typically fall into two categories: - -- Long running, general purpose frames, that exit only when instructed to. These frames should exit when they are requested. - -- Short running, very specific frames that exit when an important criteria is met. These frames may consider not exiting when they are requested in favor of waiting for their exit criteria to be met. These frames should have a time-out associated with them. - -- - -- At application shutdown, all frames are request to exit. + + typically fall into two categories: + +- Long running, general purpose frames, that exit only when instructed to. These frames should exit when they are requested. + +- Short running, very specific frames that exit when an important criteria is met. These frames may consider not exiting when they are requested in favor of waiting for their exit criteria to be met. These frames should have a time-out associated with them. + +At application shutdown, all frames are requested to exit. ]]> diff --git a/xml/System/ArgumentOutOfRangeException.xml b/xml/System/ArgumentOutOfRangeException.xml index 33e6d46e4c8..6f1e061ce2b 100644 --- a/xml/System/ArgumentOutOfRangeException.xml +++ b/xml/System/ArgumentOutOfRangeException.xml @@ -48,7 +48,7 @@ exception is thrown when a method is invoked and at least one of the arguments passed to the method is not `null` and contains an invalid value that is not a member of the set of values expected for the argument. The property identifies the invalid argument, and the property, if a value is present, identifies the invalid value. + An exception is thrown when a method is invoked and at least one of the arguments passed to the method is not `null` and contains an invalid value that is not a member of the set of values expected for the argument. The property identifies the invalid argument, and the property, if a value is present, identifies the invalid value. Typically, an results from developer error. Instead of handling the exception in a `try`/`catch` block, you should eliminate the cause of the exception or, if the argument is returned by a method call or input by the user before being passed to the method that throws the exception, you should validate arguments before passing them to the method. @@ -60,7 +60,7 @@ - String manipulation methods in the class. - The conditions in which an exception is thrown include the following: + The conditions in which an exception is thrown include the following: You are retrieving the member of a collection by its index number, and the index number is invalid. This is the most common cause of an exception. Typically, the index number is invalid for one of three reasons: @@ -132,9 +132,7 @@ [!code-csharp[System.ArgumentOutOfRangeException#18](~/samples/snippets/csharp/VS_Snippets_CLR_System/System.ArgumentOutOfRangeException/cs/NoFind2.cs#18)] [!code-vb[System.ArgumentOutOfRangeException#18](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/System.ArgumentOutOfRangeException/vb/NoFind2.vb#18)] -- - - You've attempted to extract a substring that is outside the range of the current string. +- You've attempted to extract a substring that is outside the range of the current string. The methods that extract substrings all require that you specify the starting position of the substring and, for substrings that do not continue to the end of the string, the number of characters in the substring. Note that this is not the *index* of the last character in the substring. An exception is typically thrown in this case because you've incorrectly calculated the number of characters in the substring. If you are using a search method like to identify the starting and ending positions of a substring: diff --git a/xml/System/Math.xml b/xml/System/Math.xml index 7d06d9109c7..2f20f4512ca 100644 --- a/xml/System/Math.xml +++ b/xml/System/Math.xml @@ -4555,7 +4555,7 @@ By default, the method uses the rounding to nearest ||Determined by `mode` parameter| ||Determined by `mode` parameter| -## Rounding and precision +### Rounding and precision In order to determine whether a rounding operation involves a midpoint value, the method multiplies the original value to be rounded by 10n, where *n* is the desired number of fractional digits in the return value, and then determines whether the remaining fractional portion of the value is greater than or equal to .5. This is a slight variation on a test for equality, and as discussed in the "Testing for Equality" section of the reference topic, tests for equality with floating-point values are problematic because of the floating-point format's issues with binary representation and precision. This means that any fractional portion of a number that is slightly less than .5 (because of a loss of precision) will not be rounded upward. @@ -4583,7 +4583,7 @@ Problems of precision in rounding midpoint values are most likely to arise in th [!code-csharp-interactive[System.Math.Round.Overload#8](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.math.round.overload/cs/precision2.cs#8)] [!code-vb[System.Math.Round.Overload#8](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.math.round.overload/vb/precision2.vb#8)] -### Rounding and single-precision floating-point values +#### Rounding and single-precision floating-point values The method includes overloads that accept arguments of type and . There are no methods that round values of type . If you pass a value to one of the overloads of the method, it is cast (in C#) or converted (in Visual Basic) to a , and the corresponding overload with a parameter is called. Although this is a widening conversion, it often involves a loss of precision, as the following example illustrates. When a value of 16.325 is passed to the method and rounded to two decimal places using the rounding to nearest convention, the result is 16.33 and not the expected result of 16.32. @@ -4594,7 +4594,7 @@ This unexpected result is due to a loss of precision in the conversion of the value to a . Note that, because this is a narrowing conversion, it requires using a cast operator or calling a conversion method. -### Examples +## Examples In addition to the examples in the [Remarks](#remarks-round) section, this article includes examples that illustrate the following overloads of the `Math.Round` method: