diff --git a/xml/System.Diagnostics.Eventing/EventProviderTraceListener.xml b/xml/System.Diagnostics.Eventing/EventProviderTraceListener.xml index e0056fee0a7..213871fef83 100644 --- a/xml/System.Diagnostics.Eventing/EventProviderTraceListener.xml +++ b/xml/System.Diagnostics.Eventing/EventProviderTraceListener.xml @@ -156,15 +156,7 @@ private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B Name of the listener. Delimiter used to delimit the event data. (For more details, see the property.) Initializes a new instance of the class using the specified provider identifier, name of the listener, and delimiter. - - - + To be added. diff --git a/xml/System.Linq/Enumerable.xml b/xml/System.Linq/Enumerable.xml index 75ad159594f..1112ffe880b 100644 --- a/xml/System.Linq/Enumerable.xml +++ b/xml/System.Linq/Enumerable.xml @@ -3352,11 +3352,11 @@ Only unique elements are returned. This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic. > [!NOTE] -> For examples of `GroupBy`, see the following topics. +> For examples of `GroupBy`, see the following articles: > -> - -> - -> - +> - +> - +> - The method returns a collection of objects, one for each distinct key that was encountered. An is an that also has a key associated with its elements. @@ -3427,11 +3427,11 @@ Only unique elements are returned. This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic. > [!NOTE] -> For examples of `GroupBy`, see the following topics. +> For examples of `GroupBy`, see the following articles: > -> - -> - -> - +> - +> - +> - The method returns a collection of objects, one for each distinct key that was encountered. An is an that also has a key associated with its elements. @@ -3592,11 +3592,11 @@ Only unique elements are returned. This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic. > [!NOTE] -> For examples of `GroupBy`, see the following topics. +> For examples of `GroupBy`, see the following articles: > -> - -> - -> - +> - +> - +> - The method returns a collection of objects, one for each distinct key that was encountered. An is an that also has a key associated with its elements. diff --git a/xml/System.Net.PeerToPeer.Collaboration/ApplicationChangedEventArgs.xml b/xml/System.Net.PeerToPeer.Collaboration/ApplicationChangedEventArgs.xml index ce672180b15..5a3133cd4ee 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/ApplicationChangedEventArgs.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/ApplicationChangedEventArgs.xml @@ -32,8 +32,6 @@ - A peer moves to a different IP address on the network -- - Every class that uses the class requires a of Unrestricted. This state is created when the object is constructed. ]]> diff --git a/xml/System.Net/HttpListenerPrefixCollection.xml b/xml/System.Net/HttpListenerPrefixCollection.xml index 5839995e259..0dd86d4e573 100644 --- a/xml/System.Net/HttpListenerPrefixCollection.xml +++ b/xml/System.Net/HttpListenerPrefixCollection.xml @@ -104,7 +104,7 @@ When a port is specified, the host element can be replaced with "`*`" to indicate that the accepts requests sent to the port if the requested URI does not match any other prefix. For example, to receive all requests sent to port 8080 when the requested URI is not handled by any other , the prefix is "`http://*:8080/`". Similarly, to specify that the accepts all requests sent to a port, replace the host element with the "`+`" character, "`https://+:8080/`". The "`*`" and "`+`" characters can be present in prefixes that include paths. - Starting with .NET 4.5.3 and Windows 10, wildcard subdomains are supported in URI prefixes that are managed by an object. To specify a wildcard subdomain, use the "*" character as part of the hostname in a URI prefix: for example, `http://*.foo.com/`, and pass this as the argument to the HttpListenerPrefixCollection.Add method. This will work on .NET 4.5.3 and Windows 10; in earlier versions, this would generate an + Starting with .NET 4.5.3 and Windows 10, wildcard subdomains are supported in URI prefixes that are managed by an object. To specify a wildcard subdomain, use the "\*" character as part of the hostname in a URI prefix: for example, `http://*.foo.com/`, and pass this as the argument to the HttpListenerPrefixCollection.Add method. This will work on .NET 4.5.3 and Windows 10; in earlier versions, this would generate an diff --git a/xml/System.ServiceModel.Channels/TransportSecurityBindingElement.xml b/xml/System.ServiceModel.Channels/TransportSecurityBindingElement.xml index 912acc1e788..e22a4b87bb3 100644 --- a/xml/System.ServiceModel.Channels/TransportSecurityBindingElement.xml +++ b/xml/System.ServiceModel.Channels/TransportSecurityBindingElement.xml @@ -46,11 +46,10 @@ 4. Create an instance of and add it to the collection. -5. Add any additional custom binding elements to the collection, such as . +5. Add any additional custom binding elements to the collection, such as . -6. - - **Note** Once an instance of this object is created, you should treat the properties of its base class, , as immutable. Calling `set` on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a run-time failure being the only indication of an issue. Two properties known to behave this way are and . There may be other properties for which this is true. +> [!NOTE] +> Once an instance of this object is created, you should treat the properties of its base class, , as immutable. Calling `set` on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a run-time failure being the only indication of an issue. Two properties known to behave this way are and . There may be other properties for which this is true. ]]> diff --git a/xml/System.Web.Hosting/HostingEnvironment.xml b/xml/System.Web.Hosting/HostingEnvironment.xml index 7c9ee56cef8..d469fc1a88d 100644 --- a/xml/System.Web.Hosting/HostingEnvironment.xml +++ b/xml/System.Web.Hosting/HostingEnvironment.xml @@ -939,12 +939,12 @@ > [!WARNING] > There are several design considerations that a developer must consider when implementing the event: > -> 1. The event is only available for applications that are configured to use the IIS integrated pipeline. -> 2. Developers must not throw errors from their implementations; throwing errors will have unpredictable results. -> 3. Due to the concurrent nature of operations within ASP.NET, there is no guarantee that ASP.NET will call a event once it has been implemented by a developer. -> 4. The event can execute concurrently with other notifications. -> 5. Developers need to be aware that ASP.NET may shut down the application domain while their event is executing and design their implementations to handle that possibility. -> 6. event handlers must not block; blocking implementations will result in deadlocks, and IIS will terminate the worker process when the rapid fail protection interval is reached. +> 1. The event is only available for applications that are configured to use the IIS integrated pipeline. +> 2. Developers must not throw errors from their implementations; throwing errors will have unpredictable results. +> 3. Due to the concurrent nature of operations within ASP.NET, there is no guarantee that ASP.NET will call a event once it has been implemented by a developer. +> 4. The event can execute concurrently with other notifications. +> 5. Developers need to be aware that ASP.NET may shut down the application domain while their event is executing and design their implementations to handle that possibility. +> 6. event handlers must not block; blocking implementations will result in deadlocks, and IIS will terminate the worker process when the rapid fail protection interval is reached. ]]> diff --git a/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml b/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml index 2642e77e1cb..8b2710fe9f3 100644 --- a/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml +++ b/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml @@ -142,32 +142,32 @@ |Character(s)|Description| |--------------------|-----------------| |A-Z|Uppercase Latin alphabetic characters| -||a-z|Lowercase Latin alphabetic characters| +|a-z|Lowercase Latin alphabetic characters| |0-9|Numbers| -|!|Exclamation mark| -|#|Number sign, hash| -|$|Dollar sign| -|%|Percent sign| +|\!|Exclamation mark| +|\#|Number sign, hash| +|\$|Dollar sign| +|\%|Percent sign| |( )|Parentheses| -|*|Asterisk| -|+|Plus sign| -|,|Comma| -|-|Hyphen, minus| -|.|Period, dot, full stop| -|/|Slash| -|:|Colon| -|;|Semicolon| -|=|Equals sign| -|?|Question mark| -|@|Commercial at-sign| -|[ ]|Square brackets| -|\|Backslash| -|^|Caret| -|_|Underscore| +|\*|Asterisk| +|\+|Plus sign| +|\,|Comma| +|\-|Hyphen, minus| +|\.|Period, dot, full stop| +|\/|Slash| +|\:|Colon| +|\;|Semicolon| +|\=|Equals sign| +|\?|Question mark| +|\@|Commercial at-sign| +|\[ \]|Square brackets| +|\\ |Backslash| +|\^|Caret| +|\_|Underscore| |\`|Grave accent| -|{ }|Braces, curly brackets| -|||Vertical line| -|~|Tilde| +|\{ \}|Braces, curly brackets| +|\||Vertical line| +|\~|Tilde| |0x00A1 - 0x00AC|Special characters between 0x00A1 (161 decimal) and 0x00AC (172 decimal) from the Unicode [C1 Controls and Latin-1 Supplement](https://www.unicode.org/charts/PDF/U0080.pdf) character range.| |0x00AE - 0x00FF|Special characters between 0x00AE (174 decimal) and 0x00FF (255 decimal) from the Unicode [C1 Controls and Latin-1 Supplement](https://www.unicode.org/charts/PDF/U0080.pdf) character range.| |0x0100 - 0x017F|Characters between 0x0100 (256 decimal) and 0x017F (383 decimal). (The Unicode [Latin-Extended-A](https://www.unicode.org/charts/PDF/U0100.pdf) character range.)| @@ -178,7 +178,7 @@ The following table lists examples of inputs and the corresponding encoded outputs. -||| +|Input examples| Encoded outputs| |-|-| |`alert('XSS Attack!');`|`alert('XSS Attack!');`| |``|`<script>alert('XSS Attack!');</script>`| @@ -1103,4 +1103,4 @@ The following table lists the default safe characters. All characters are from t - \ No newline at end of file + diff --git a/xml/System.Windows.Media.Media3D/Vector3DCollection.xml b/xml/System.Windows.Media.Media3D/Vector3DCollection.xml index 00d0f05e773..6fa2be2508f 100644 --- a/xml/System.Windows.Media.Media3D/Vector3DCollection.xml +++ b/xml/System.Windows.Media.Media3D/Vector3DCollection.xml @@ -69,7 +69,7 @@ *oneOrMoreVector3Ds* One or more objects, with each set of values delimited by commas and/or one or more spaces: - *[delimiter* *]\** + _[delimiter__]\*_ For example, `"0,0,5 100,100,150 200,100,75"` and `"0,0,5,100,100,150,200,100,75"` are both valid. diff --git a/xml/System.Windows.Media/DoubleCollection.xml b/xml/System.Windows.Media/DoubleCollection.xml index 85ceaf0ce23..cb15a76f554 100644 --- a/xml/System.Windows.Media/DoubleCollection.xml +++ b/xml/System.Windows.Media/DoubleCollection.xml @@ -72,7 +72,7 @@ *oneOrMoreDoubleValues* One or more values, with each pair delimited by a single comma and/or one or more spaces: - *[delimiter* *]\** + _[delimiter__]\*_ For example, `"0.5 1.0 43"` and `"0.5,1.0,43"` are both valid. diff --git a/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml b/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml index 5af56810e83..6f910a8b954 100644 --- a/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml +++ b/xml/ns-System.Data.Common.CommandTrees.ExpressionBuilder.xml @@ -5,16 +5,15 @@ API is used to create expressions, which are represented by objects. The command tree API provided by the class has the following characteristics: - -- Functional. objects are constructed using functional patterns that provide a natural flow of construction. - -- Loosely-coupled. A object is not bound to any specific command tree and can be used in any context where type agreement is satisfied. - -- Immutable. The API consists entirely of immutable types; mutability may be simulated by substituting new values while rebuilding an expression tree. - -- - + +The API is used to create expressions, which are represented by objects. The command tree API provided by the class has the following characteristics: + +- Functional: objects are constructed using functional patterns that provide a natural flow of construction. + +- Loosely-coupled: A object is not bound to any specific command tree and can be used in any context where type agreement is satisfied. + +- Immutable: The API consists entirely of immutable types; mutability may be simulated by substituting new values while rebuilding an expression tree. + ]]>