From 592660db911f8302595bb1e72e52f4b2b377ce33 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Mon, 2 Dec 2024 06:57:28 -0800
Subject: [PATCH] Escape $ signs where needed (#10715)

---
 xml/Microsoft.VisualBasic/Financial.xml       |  417 +++---
 xml/System.Data.Objects/CompiledQuery.xml     |  220 ++-
 .../IDataServiceConfiguration.xml             |   70 +-
 xml/System.Diagnostics/EventLogInstaller.xml  | 1328 ++++++++---------
 xml/System.Globalization/NumberFormatInfo.xml |  191 +--
 xml/System.Net/Cookie.xml                     |  594 ++++----
 xml/System.Net/CookieException.xml            |    2 +-
 .../CodeConnectAccess.xml                     |  324 ++--
 .../SrgsRule.xml                              |   10 +-
 .../RecognizedWordUnit.xml                    |  922 ++++++------
 .../JsonPolymorphismOptions.xml               |    2 +-
 .../ReferenceResolver.xml                     |   18 +-
 .../JsonSerializerOptions.xml                 |    8 +-
 xml/System.Text/UTF7Encoding.xml              |  750 +++++-----
 xml/System.Web.UI.WebControls/BoundField.xml  |  602 ++++----
 xml/System.Web.UI.WebControls/ListControl.xml |    6 +-
 .../RegularExpressionValidator.xml            |    4 +-
 xml/System/Byte.xml                           |    4 +-
 18 files changed, 2690 insertions(+), 2782 deletions(-)

diff --git a/xml/Microsoft.VisualBasic/Financial.xml b/xml/Microsoft.VisualBasic/Financial.xml
index c60d0cdf01d..01c63250521 100644
--- a/xml/Microsoft.VisualBasic/Financial.xml
+++ b/xml/Microsoft.VisualBasic/Financial.xml
@@ -37,20 +37,18 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>The <see langword="Financial" /> module contains procedures used to perform financial operations.</summary>
+    <summary>Contains procedures used to perform financial operations.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This module supports the Visual Basic run-time library members that perform financial calculations such as depreciation, present and future values, interest rates, rates of return, and payments.  
-  
-   
-  
-## Examples  
- This example uses the `Rate` function to calculate the interest rate of a loan, given the total number of payments (`TotPmts`), the amount of the loan payment (`Payment`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`), and an approximation of the expected interest rate (`Guess`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet2":::  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This module supports the Visual Basic run-time library members that perform financial calculations such as depreciation, present and future values, interest rates, rates of return, and payments.
+
+## Examples
+ This example uses the `Rate` function to calculate the interest rate of a loan, given the total number of payments (`TotPmts`), the amount of the loan payment (`Payment`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`), and an approximation of the expected interest rate (`Guess`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet2":::
+
  ]]></format>
     </remarks>
     <related type="Article" href="/dotnet/visual-basic/language-reference/keywords/financial-summary">Financial Summary</related>
@@ -101,24 +99,22 @@
         <summary>Returns a value specifying the depreciation of an asset for a specific time period using the double-declining balance method or some other method you specify.</summary>
         <returns>The depreciation of an asset for a specific time period using the double-declining balance method or some other method you specify.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The double-declining balance method computes depreciation at an accelerated rate. Depreciation is highest in the first period and decreases in successive periods.  
-  
- The `Life` and `Period` arguments must be expressed in the same units. For example, if `Life` is given in months, `Period` must also be given in months. All arguments must be positive numbers.  
-  
- The `DDB` function uses the following formula to calculate depreciation for a given period:  
-  
- Depreciation / Period = ((Cost - Salvage) * Factor) / Life  
-  
-   
-  
-## Examples  
- This example uses the `DDB` function to return the depreciation of an asset for a specified period given the initial cost (`InitCost`), the salvage value at the end of the asset's useful life (`SalvageVal`), the total life of the asset in years (`LifeTime`), and the period in years for which the depreciation is calculated (`Depr`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet3":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The double-declining balance method computes depreciation at an accelerated rate. Depreciation is highest in the first period and decreases in successive periods.
+
+ The `Life` and `Period` arguments must be expressed in the same units. For example, if `Life` is given in months, `Period` must also be given in months. All arguments must be positive numbers.
+
+ The `DDB` function uses the following formula to calculate depreciation for a given period:
+
+ Depreciation / Period = ((Cost - Salvage) * Factor) / Life
+
+## Examples
+ This example uses the `DDB` function to return the depreciation of an asset for a specified period given the initial cost (`InitCost`), the salvage value at the end of the asset's useful life (`SalvageVal`), the total life of the asset in years (`LifeTime`), and the period in years for which the depreciation is calculated (`Depr`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -178,22 +174,20 @@
         <summary>Returns a value specifying the future value of an annuity based on periodic, fixed payments and a fixed interest rate.</summary>
         <returns>The future value of an annuity based on periodic, fixed payments and a fixed interest rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made over time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.  
-  
- For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `FV` function to return the future value of an investment given the percentage rate that accrues per period (`APR / 12`), the total number of payments (`TotPmts`), the payment (`Payment`), the current value of the investment (`PVal`), and a number that indicates whether the payment is made at the beginning or end of the payment period (`PayType`). Note that because `Payment` represents cash paid out, it is a negative number.  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet22":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made over time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.
+
+ For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+## Examples
+ This example uses the `FV` function to return the future value of an investment given the percentage rate that accrues per period (`APR / 12`), the total number of payments (`TotPmts`), the payment (`Payment`), the current value of the investment (`PVal`), and a number that indicates whether the payment is made at the beginning or end of the payment period (`PayType`). Note that because `Payment` represents cash paid out, it is a negative number.
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet22":::
+
  ]]></format>
         </remarks>
         <related type="Article" href="/dotnet/visual-basic/language-reference/keywords/financial-summary">Financial Summary</related>
@@ -239,27 +233,25 @@
         <param name="Per">Required. The payment period in the range 1 through <paramref name="NPer" />.</param>
         <param name="NPer">Required. The total number of payment periods in the annuity. For example, if you make monthly payments on a four-year car loan, your loan has a total of 4 x 12 (or 48) payment periods.</param>
         <param name="PV">Required. The present value, or value today, of a series of future payments or receipts. For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.</param>
-        <param name="FV">Optional. The future value or cash balance you want after you've made the final payment. For example, the future value of a loan is $0 because that's its value after the final payment. However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value. If omitted, 0 is assumed.</param>
+        <param name="FV">Optional. The future value or cash balance you want after you've made the final payment. For example, the future value of a loan is \\$0 because that's its value after the final payment. However, if you want to save \\$50,000 over 18 years for your child's education, then \\$50,000 is the future value. If omitted, 0 is assumed.</param>
         <param name="Due">Optional. Object of type <see cref="T:Microsoft.VisualBasic.DueDate" /> that specifies when payments are due. This argument must be either <c>DueDate.EndOfPeriod</c> if payments are due at the end of the payment period, or <c>DueDate.BegOfPeriod</c> if payments are due at the beginning of the period. If omitted, <c>DueDate.EndOfPeriod</c> is assumed.</param>
         <summary>Returns a value specifying the interest payment for a given period of an annuity based on periodic, fixed payments and a fixed interest rate.</summary>
         <returns>The interest payment for a given period of an annuity based on periodic, fixed payments and a fixed interest rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made over time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.  
-  
- For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `IPmt` function to calculate how much of a payment is interest when all the payments are of equal value. Given are the interest percentage rate per period (`APR / 12`), the payment period for which the interest portion is desired (`Period`), the total number of payments (`TotPmts`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet26":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made over time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.
+
+ For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+## Examples
+ This example uses the `IPmt` function to calculate how much of a payment is interest when all the payments are of equal value. Given are the interest percentage rate per period (`APR / 12`), the payment period for which the interest portion is desired (`Period`), the total number of payments (`TotPmts`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet26":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -305,22 +297,20 @@
         <summary>Returns a value specifying the internal rate of return for a series of periodic cash flows (payments and receipts).</summary>
         <returns>The internal rate of return for a series of periodic cash flows (payments and receipts).</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The internal rate of return is the interest rate received for an investment consisting of payments and receipts that occur at regular intervals.  
-  
- The `IRR` function uses the order of values within the array to interpret the order of payments and receipts. Be sure to enter your payment and receipt values in the correct sequence. The cash flow for each period does not need to be fixed, as it is for an annuity.  
-  
- `IRR` is calculated by iteration. Starting with the value of `Guess`, `IRR` cycles through the calculation until the result is accurate to within 0.00001 percent. If `IRR` cannot find a result after 20 tries, it fails.  
-  
-   
-  
-## Examples  
- In this example, the `IRR` function returns the internal rate of return for a series of five cash flows contained in the array `Values()`. The first array element is a negative cash flow representing business start-up costs. The remaining four cash flows represent positive cash flows for the subsequent four years. `Guess` is the estimated internal rate of return.  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet20":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The internal rate of return is the interest rate received for an investment consisting of payments and receipts that occur at regular intervals.
+
+ The `IRR` function uses the order of values within the array to interpret the order of payments and receipts. Be sure to enter your payment and receipt values in the correct sequence. The cash flow for each period does not need to be fixed, as it is for an annuity.
+
+ `IRR` is calculated by iteration. Starting with the value of `Guess`, `IRR` cycles through the calculation until the result is accurate to within 0.00001 percent. If `IRR` cannot find a result after 20 tries, it fails.
+
+## Examples
+ In this example, the `IRR` function returns the internal rate of return for a series of five cash flows contained in the array `Values()`. The first array element is a negative cash flow representing business start-up costs. The remaining four cash flows represent positive cash flows for the subsequent four years. `Guess` is the estimated internal rate of return.
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet20":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">Array argument values are invalid or <paramref name="Guess" /> &lt;= -1.</exception>
@@ -370,22 +360,20 @@
         <summary>Returns a value specifying the modified internal rate of return for a series of periodic cash flows (payments and receipts).</summary>
         <returns>The modified internal rate of return for a series of periodic cash flows (payments and receipts).</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The modified internal rate of return is the internal rate of return when payments and receipts are financed at different rates. The `MIRR` function takes into account both the cost of the investment (`FinanceRate`) and the interest rate received on reinvestment of cash (`ReinvestRate`).  
-  
- The `FinanceRate` and `ReinvestRate` arguments are percentages expressed as decimal values. For example, 12 percent is expressed as 0.12.  
-  
- The `MIRR` function uses the order of values within the array to interpret the order of payments and receipts. Be sure to enter your payment and receipt values in the correct sequence.  
-  
-   
-  
-## Examples  
- This example uses the `MIRR` function to return the modified internal rate of return for a series of cash flows contained in the array `Values()`. `LoanAPR` represents the financing interest, and `InvAPR` represents the interest rate received on reinvestment.  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet29":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The modified internal rate of return is the internal rate of return when payments and receipts are financed at different rates. The `MIRR` function takes into account both the cost of the investment (`FinanceRate`) and the interest rate received on reinvestment of cash (`ReinvestRate`).
+
+ The `FinanceRate` and `ReinvestRate` arguments are percentages expressed as decimal values. For example, 12 percent is expressed as 0.12.
+
+ The `MIRR` function uses the order of values within the array to interpret the order of payments and receipts. Be sure to enter your payment and receipt values in the correct sequence.
+
+## Examples
+ This example uses the `MIRR` function to return the modified internal rate of return for a series of cash flows contained in the array `Values()`. `LoanAPR` represents the financing interest, and `InvAPR` represents the interest rate received on reinvestment.
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet29":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">Rank of <paramref name="ValueArray" /> does not equal 1, <paramref name="FinanceRate" /> = -1, or <paramref name="ReinvestRate" /> = -1</exception>
@@ -435,25 +423,23 @@
         <param name="Rate">Required. The interest rate per period. For example, if you get a car loan at an annual percentage rate (APR) of 10 percent and make monthly payments, the rate per period is 0.1/12, or 0.0083.</param>
         <param name="Pmt">Required. The payment to be made each period. Payments usually contain principal and interest that does not change over the life of the annuity.</param>
         <param name="PV">Required. The present value, or value today, of a series of future payments or receipts. For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.</param>
-        <param name="FV">Optional. The future value or cash balance you want after you have made the final payment. For example, the future value of a loan is $0 because that is its value after the final payment. However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value. If omitted, 0 is assumed.</param>
+        <param name="FV">Optional. The future value or cash balance you want after you have made the final payment. For example, the future value of a loan is \\$0 because that is its value after the final payment. However, if you want to save \\$50,000 over 18 years for your child's education, then \\$50,000 is the future value. If omitted, 0 is assumed.</param>
         <param name="Due">Optional. Object of type <see cref="T:Microsoft.VisualBasic.DueDate" /> that specifies when payments are due. This argument must be either <c>DueDate.EndOfPeriod</c> if payments are due at the end of the payment period, or <c>DueDate.BegOfPeriod</c> if payments are due at the beginning of the period. If omitted, <c>DueDate.EndOfPeriod</c> is assumed.</param>
         <summary>Returns a value specifying the number of periods for an annuity based on periodic fixed payments and a fixed interest rate.</summary>
         <returns>The number of periods for an annuity based on periodic fixed payments and a fixed interest rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `NPer` function to return the number of periods during which payments must be made to pay off a loan whose value is contained in `PVal`. Also provided are the interest percentage rate per period (`APR / 12`), the payment (`Payment`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet19":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+## Examples
+ This example uses the `NPer` function to return the number of periods during which payments must be made to pay off a loan whose value is contained in `PVal`. Also provided are the interest percentage rate per period (`APR / 12`), the payment (`Payment`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet19":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -500,26 +486,24 @@
         <summary>Returns a value specifying the net present value of an investment based on a series of periodic cash flows (payments and receipts) and a discount rate.</summary>
         <returns>The net present value of an investment based on a series of periodic cash flows (payments and receipts) and a discount rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The net present value of an investment is the current value of a future series of payments and receipts.  
-  
- The `NPV` function uses the order of values within the array to interpret the order of payments and receipts. Be sure to enter your payment and receipt values in the correct sequence.  
-  
- The `NPV` investment begins one period before the date of the first cash flow value and ends with the last cash flow value in the array.  
-  
- The net present value calculation is based on future cash flows. If your first cash flow occurs at the beginning of the first period, the first value must be added to the value returned by `NPV` and must not be included in the cash flow values of `ValueArray`.  
-  
- The `NPV` function is similar to the `PV` function (present value) except that the `PV` function allows cash flows to begin either at the end or the beginning of a period. Unlike the variable `NPV` cash flow values, `PV` cash flows must be fixed throughout the investment.  
-  
-   
-  
-## Examples  
- This example uses the `NPV` function to return the net present value for a series of cash flows contained in the array `values()`. The return value, stored in `FixedRetRate`, represents the fixed internal rate of return.  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet1":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The net present value of an investment is the current value of a future series of payments and receipts.
+
+ The `NPV` function uses the order of values within the array to interpret the order of payments and receipts. Be sure to enter your payment and receipt values in the correct sequence.
+
+ The `NPV` investment begins one period before the date of the first cash flow value and ends with the last cash flow value in the array.
+
+ The net present value calculation is based on future cash flows. If your first cash flow occurs at the beginning of the first period, the first value must be added to the value returned by `NPV` and must not be included in the cash flow values of `ValueArray`.
+
+ The `NPV` function is similar to the `PV` function (present value) except that the `PV` function allows cash flows to begin either at the end or the beginning of a period. Unlike the variable `NPV` cash flow values, `PV` cash flows must be fixed throughout the investment.
+
+## Examples
+ This example uses the `NPV` function to return the net present value for a series of cash flows contained in the array `values()`. The return value, stored in `FixedRetRate`, represents the fixed internal rate of return.
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -574,27 +558,25 @@
         <param name="Rate">Required. The interest rate per period. For example, if you get a car loan at an annual percentage rate (APR) of 10 percent and make monthly payments, the rate per period is 0.1/12, or 0.0083.</param>
         <param name="NPer">Required. The total number of payment periods in the annuity. For example, if you make monthly payments on a four-year car loan, your loan has a total of 4 × 12 (or 48) payment periods.</param>
         <param name="PV">Required. The present value (or lump sum) that a series of payments to be paid in the future is worth now. For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.</param>
-        <param name="FV">Optional. The future value or cash balance you want after you have made the final payment. For example, the future value of a loan is $0 because that is its value after the final payment. However, if you want to save $50,000 during 18 years for your child's education, then $50,000 is the future value. If omitted, 0 is assumed.</param>
+        <param name="FV">Optional. The future value or cash balance you want after you have made the final payment. For example, the future value of a loan is \\$0 because that is its value after the final payment. However, if you want to save \\$50,000 during 18 years for your child's education, then \\$50,000 is the future value. If omitted, 0 is assumed.</param>
         <param name="Due">Optional. Object of type <see cref="T:Microsoft.VisualBasic.DueDate" /> that specifies when payments are due. This argument must be either <c>DueDate.EndOfPeriod</c> if payments are due at the end of the payment period, or <c>DueDate.BegOfPeriod</c> if payments are due at the beginning of the period. If omitted, <c>DueDate.EndOfPeriod</c> is assumed.</param>
         <summary>Returns a value specifying the payment for an annuity based on periodic, fixed payments and a fixed interest rate.</summary>
         <returns>The payment for an annuity based on periodic, fixed payments and a fixed interest rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made during a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.  
-  
- For all arguments, cash paid (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `Pmt` function to return the monthly payment for a loan during a fixed period. Given are the interest percentage rate per period (`APR / 12`), the total number of payments (`TotPmts`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period `(PayType).`  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet7":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made during a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.
+
+ For all arguments, cash paid (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+## Examples
+ This example uses the `Pmt` function to return the monthly payment for a loan during a fixed period. Given are the interest percentage rate per period (`APR / 12`), the total number of payments (`TotPmts`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period `(PayType).`
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet7":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -643,27 +625,25 @@
         <param name="Per">Required. The payment period in the range 1 through <paramref name="NPer" />.</param>
         <param name="NPer">Required. The total number of payment periods in the annuity. For example, if you make monthly payments on a four-year car loan, your loan has a total of 4 x 12 (or 48) payment periods.</param>
         <param name="PV">Required. The current value of a series of future payments or receipts. For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.</param>
-        <param name="FV">Optional. The future value or cash balance you want after you have made the final payment. For example, the future value of a loan is $0 because that is its value after the final payment. However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value. If omitted, 0 is assumed.</param>
+        <param name="FV">Optional. The future value or cash balance you want after you have made the final payment. For example, the future value of a loan is \\$0 because that is its value after the final payment. However, if you want to save \\$50,000 over 18 years for your child's education, then \\$50,000 is the future value. If omitted, 0 is assumed.</param>
         <param name="Due">Optional. Object of type <see cref="T:Microsoft.VisualBasic.DueDate" /> that specifies when payments are due. This argument must be either <c>DueDate.EndOfPeriod</c> if payments are due at the end of the payment period, or <c>DueDate.BegOfPeriod</c> if payments are due at the beginning of the period. If omitted, <c>DueDate.EndOfPeriod</c> is assumed.</param>
         <summary>Returns a value specifying the principal payment for a given period of an annuity based on periodic fixed payments and a fixed interest rate.</summary>
         <returns>The principal payment for a given period of an annuity based on periodic fixed payments and a fixed interest rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.  
-  
- For all arguments, cash paid (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `PPmt` function to calculate how much of a payment for a specific period is principal when all the payments are of equal value. Given are the interest percentage rate per period (`APR / 12`), the payment period for which the principal portion is desired (`Period`), the total number of payments (`TotPmts`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet24":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.
+
+ For all arguments, cash paid (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+## Examples
+ This example uses the `PPmt` function to calculate how much of a payment for a specific period is principal when all the payments are of equal value. Given are the interest percentage rate per period (`APR / 12`), the payment period for which the principal portion is desired (`Period`), the total number of payments (`TotPmts`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), and a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet24":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -710,27 +690,25 @@
         <param name="Rate">Required. The interest rate per period. For example, if you get a car loan at an annual percentage rate (APR) of 10 percent and make monthly payments, the rate per period is 0.1/12, or 0.0083.</param>
         <param name="NPer">Required. The total number of payment periods in the annuity. For example, if you make monthly payments on a four-year car loan, your loan has 4 x 12 (or 48) payment periods.</param>
         <param name="Pmt">Required. The payment to be made each period. Payments usually contain principal and interest that does not change during the life of the annuity.</param>
-        <param name="FV">Optional. The future value or cash balance you want after you make the final payment. For example, the future value of a loan is $0 because that is its value after the final payment. However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value. If omitted, 0 is assumed.</param>
+        <param name="FV">Optional. The future value or cash balance you want after you make the final payment. For example, the future value of a loan is \\$0 because that is its value after the final payment. However, if you want to save \\$50,000 over 18 years for your child's education, then \\$50,000 is the future value. If omitted, 0 is assumed.</param>
         <param name="Due">Optional. Object of type <see cref="T:Microsoft.VisualBasic.DueDate" /> that specifies when payments are due. This argument must be either <c>DueDate.EndOfPeriod</c> if payments are due at the end of the payment period, or <c>DueDate.BegOfPeriod</c> if payments are due at the beginning of the period. If omitted, <c>DueDate.EndOfPeriod</c> is assumed.</param>
         <summary>Returns a value specifying the present value of an annuity based on periodic, fixed payments to be paid in the future and a fixed interest rate.</summary>
         <returns>The present value of an annuity based on periodic, fixed payments to be paid in the future and a fixed interest rate.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.  
-  
- For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
-   
-  
-## Examples  
- In this example, the `PV` function returns the present value of an $1,000,000 annuity that will provide $50,000 a year for the next 20 years. Provided are the expected annual percentage rate (`APR`), the total number of payments (`TotPmts`), the amount of each payment (`YrIncome`), the total future value of the investment (`FVal`), and a number that indicates whether each payment is made at the beginning or end of the payment period (`PayType`). Note that `YrIncome` is a negative number because it represents cash paid out from the annuity each year.  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet25":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ The `Rate` and `NPer` arguments must be calculated using payment periods expressed in the same units. For example, if `Rate` is calculated using months, `NPer` must also be calculated using months.
+
+ For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+## Examples
+ In this example, the `PV` function returns the present value of an \\$1,000,000 annuity that will provide \\$50,000 a year for the next 20 years. Provided are the expected annual percentage rate (`APR`), the total number of payments (`TotPmts`), the amount of each payment (`YrIncome`), the total future value of the investment (`FVal`), and a number that indicates whether each payment is made at the beginning or end of the payment period (`PayType`). Note that `YrIncome` is a negative number because it represents cash paid out from the annuity each year.
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet25":::
+
  ]]></format>
         </remarks>
         <related type="Article" href="/dotnet/visual-basic/language-reference/keywords/financial-summary">Financial Summary</related>
@@ -775,28 +753,26 @@
         <param name="NPer">Required. The total number of payment periods in the annuity. For example, if you make monthly payments on a four-year car loan, your loan has a total of 4 * 12 (or 48) payment periods.</param>
         <param name="Pmt">Required. The payment to be made each period. Payments usually contain principal and interest that doesn't change over the life of the annuity.</param>
         <param name="PV">Required. The present value, or value today, of a series of future payments or receipts. For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.</param>
-        <param name="FV">Optional. The future value or cash balance you want after you make the final payment. For example, the future value of a loan is $0 because that is its value after the final payment. However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value. If omitted, 0 is assumed.</param>
+        <param name="FV">Optional. The future value or cash balance you want after you make the final payment. For example, the future value of a loan is \\$0 because that is its value after the final payment. However, if you want to save \\$50,000 over 18 years for your child's education, then \\$50,000 is the future value. If omitted, 0 is assumed.</param>
         <param name="Due">Optional. Object of type <see cref="T:Microsoft.VisualBasic.DueDate" /> that specifies when payments are due. This argument must be either <c>DueDate.EndOfPeriod</c> if payments are due at the end of the payment period, or <c>DueDate.BegOfPeriod</c> if payments are due at the beginning of the period. If omitted, <c>DueDate.EndOfPeriod</c> is assumed.</param>
         <param name="Guess">Optional. The value you estimate is returned by <see langword="Rate" />. If omitted, <paramref name="Guess" /> is 0.1 (10 percent).</param>
         <summary>Returns a value specifying the interest rate per period for an annuity.</summary>
         <returns>The interest rate per period for an annuity.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).  
-  
- For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.  
-  
- `Rate` is calculated by iteration. Starting with the value of `Guess`, `Rate` cycles through the calculation until the result is accurate to within 0.00001 percent. If `Rate` cannot find a result after 20 tries, it fails. If your guess is 10 percent and `Rate` fails, try a different value for `Guess`.  
-  
-   
-  
-## Examples  
- This example uses the `Rate` function to calculate the interest rate of a loan given the total number of payments (`TotPmts`), the amount of the loan payment (`Payment`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`), and an approximation of the expected interest rate (`Guess`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet2":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ An annuity is a series of fixed cash payments made over a period of time. An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
+
+ For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.
+
+ `Rate` is calculated by iteration. Starting with the value of `Guess`, `Rate` cycles through the calculation until the result is accurate to within 0.00001 percent. If `Rate` cannot find a result after 20 tries, it fails. If your guess is 10 percent and `Rate` fails, try a different value for `Guess`.
+
+## Examples
+ This example uses the `Rate` function to calculate the interest rate of a loan given the total number of payments (`TotPmts`), the amount of the loan payment (`Payment`), the present value or principal of the loan (`PVal`), the future value of the loan (`FVal`), a number that indicates whether the payment is due at the beginning or end of the payment period (`PayType`), and an approximation of the expected interest rate (`Guess`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet2":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -845,18 +821,16 @@
         <summary>Returns a value specifying the straight-line depreciation of an asset for a single period.</summary>
         <returns>The straight-line depreciation of an asset for a single period.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The depreciation period must be expressed in the same unit as the `Life` argument. All arguments must be positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `SLN` function to return the straight-line depreciation of an asset for a single period given the asset's initial cost (`InitCost`), the salvage value at the end of the asset's useful life (`SalvageVal`), and the total life of the asset in years (`LifeTime`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet3":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The depreciation period must be expressed in the same unit as the `Life` argument. All arguments must be positive numbers.
+
+## Examples
+ This example uses the `SLN` function to return the straight-line depreciation of an asset for a single period given the asset's initial cost (`InitCost`), the salvage value at the end of the asset's useful life (`SalvageVal`), and the total life of the asset in years (`LifeTime`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
@@ -909,18 +883,15 @@
         <summary>Returns a value specifying the sum-of-years digits depreciation of an asset for a specified period.</summary>
         <returns>The sum-of-years digits depreciation of an asset for a specified period.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The `Life` and `Period` arguments must be expressed in the same units. For example, if `Life` is given in months, `Period` must also be given in months. All arguments must be positive numbers.  
-  
-   
-  
-## Examples  
- This example uses the `SYD` function to return the depreciation of an asset for a specified period given the asset's initial cost (`InitCost`), the salvage value at the end of the asset's useful life (`SalvageVal`), and the total life of the asset in years (`LifeTime`).  
-  
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet3":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The `Life` and `Period` arguments must be expressed in the same units. For example, if `Life` is given in months, `Period` must also be given in months. All arguments must be positive numbers.
+## Examples
+ This example uses the `SYD` function to return the depreciation of an asset for a specified period given the asset's initial cost (`InitCost`), the salvage value at the end of the asset's useful life (`SalvageVal`), and the total life of the asset in years (`LifeTime`).
+
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrMath/VB/Class1.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
diff --git a/xml/System.Data.Objects/CompiledQuery.xml b/xml/System.Data.Objects/CompiledQuery.xml
index da7aff110c3..6e93d70d983 100644
--- a/xml/System.Data.Objects/CompiledQuery.xml
+++ b/xml/System.Data.Objects/CompiledQuery.xml
@@ -17,19 +17,17 @@
   <Docs>
     <summary>Represents a cached LINQ to Entities query.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Provides for compilation and caching of queries for reuse. Conceptually this class contains a single `Compile` method with several overloads. You call the `Compile` method to create a new delegate to represent the compiled query. The delegate, when invoked with the <xref:System.Data.Objects.ObjectContext> input parameter and other parameter values, produces some result (such as an <xref:System.Linq.IQueryable%601> instance). The query is translated and cached when the delegate is invoked for the first time.  
-  
-   
-  
-## Examples  
- The following example compiles and then invokes a query that accepts <xref:System.DateTime> and <xref:System.Decimal> input parameters and returns a sequence of orders where the order date is later than March 8, 2003 and the total due is less than $300.00:  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Provides for compilation and caching of queries for reuse. Conceptually this class contains a single `Compile` method with several overloads. You call the `Compile` method to create a new delegate to represent the compiled query. The delegate, when invoked with the <xref:System.Data.Objects.ObjectContext> input parameter and other parameter values, produces some result (such as an <xref:System.Linq.IQueryable%601> instance). The query is translated and cached when the delegate is invoked for the first time.
+
+## Examples
+ The following example compiles and then invokes a query that accepts <xref:System.DateTime> and <xref:System.Decimal> input parameters and returns a sequence of orders where the order date is later than March 8, 2003 and the total due is less than $300.00:
+
  :::code language="csharp" source="~/snippets/csharp/System.Data.Objects/CompiledQuery/Overview/Program.cs" id="Snippetcompiledquery5":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery5":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery5":::
+
  ]]></format>
     </remarks>
     <related type="Article" href="/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities">Compiled Queries (LINQ to Entities)</related>
@@ -70,19 +68,19 @@
         <returns>
           <see cref="T:System.Func`2" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
-   
-  
-## Examples  
- The following example compiles and then invokes a query that returns an <xref:System.Data.Objects.ObjectQuery%601> instance:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
+
+
+## Examples
+ The following example compiles and then invokes a query that returns an <xref:System.Data.Objects.ObjectQuery%601> instance:
+
  :::code language="csharp" source="~/snippets/csharp/System.Data.Objects/CompiledQuery/Overview/Program.cs" id="Snippetcompiledquery1_mq":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery1_mq":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery1_mq":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -124,19 +122,17 @@
         <returns>
           <see cref="T:System.Func`3" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
-   
-  
-## Examples  
- The following example compiles and then invokes a query that accepts a <xref:System.Decimal> input parameter and returns a sequence of orders where the total due is greater than or equal to $200.00:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
+## Examples
+ The following example compiles and then invokes a query that accepts a <xref:System.Decimal> input parameter and returns a sequence of orders where the total due is greater than or equal to $200.00:
+
  :::code language="csharp" source="~/snippets/csharp/System.Data.Objects/CompiledQuery/Overview/Program.cs" id="Snippetcompiledquery2":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery2":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery2":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -180,19 +176,17 @@
         <returns>
           <see cref="T:System.Func`4" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
-   
-  
-## Examples  
- The following example compiles and then invokes a query that accepts <xref:System.DateTime> and <xref:System.Decimal> input parameters and returns a sequence of orders where the order date is later than March 8, 2003 and the total due is less than $300.00:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
+## Examples
+ The following example compiles and then invokes a query that accepts <xref:System.DateTime> and <xref:System.Decimal> input parameters and returns a sequence of orders where the order date is later than March 8, 2003 and the total due is less than $300.00:
+
  :::code language="csharp" source="~/snippets/csharp/System.Data.Objects/CompiledQuery/Overview/Program.cs" id="Snippetcompiledquery5":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery5":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb" id="Snippetcompiledquery5":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -238,11 +232,11 @@
         <returns>
           <see cref="T:System.Func`5" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -289,11 +283,11 @@
         <returns>
           <see cref="T:System.Func`6" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -342,11 +336,11 @@
         <returns>
           <see cref="T:System.Func`7" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -397,11 +391,11 @@
         <returns>
           <see cref="T:System.Func`8" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -454,11 +448,11 @@
         <returns>
           <see cref="T:System.Func`9" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -513,11 +507,11 @@
         <returns>
           <see cref="T:System.Func`10" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -574,11 +568,11 @@
         <returns>
           <see cref="T:System.Func`11" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -637,11 +631,11 @@
         <returns>
           <see cref="T:System.Func`12" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -702,11 +696,11 @@
         <returns>
           <see cref="T:System.Func`13" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -769,11 +763,11 @@
         <returns>
           <see cref="T:System.Func`14" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -838,11 +832,11 @@
         <returns>
           <see cref="T:System.Func`15" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -909,11 +903,11 @@
         <returns>
           <see cref="T:System.Func`16" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
@@ -982,11 +976,11 @@
         <returns>
           <see cref="T:System.Func`17" />, a generic delegate that represents the compiled LINQ to Entities query.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information and examples, see [Compiled Queries  (LINQ to Entities)](/dotnet/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities).
+
  ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Data.Services/IDataServiceConfiguration.xml b/xml/System.Data.Services/IDataServiceConfiguration.xml
index c87d40c7e7e..20b5f0514ba 100644
--- a/xml/System.Data.Services/IDataServiceConfiguration.xml
+++ b/xml/System.Data.Services/IDataServiceConfiguration.xml
@@ -14,11 +14,11 @@
   <Docs>
     <summary>The <see cref="T:System.Data.Services.IDataServiceConfiguration" /> is used by WCF Data Services to set up the behavior of the service, including rights on entity sets and service operations, limits on the allowed requests, registering types not discoverable by default, and the default verbosity on error handling.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This type is used by <xref:System.Data.Services.DataService%601> classes to configure the service by implementing a static method named InitializeService, returning void, and taking a single argument of type <xref:System.Data.Services.IDataServiceConfiguration>. The configuration object may only be used during the call to service initialization.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This type is used by <xref:System.Data.Services.DataService%601> classes to configure the service by implementing a static method named InitializeService, returning void, and taking a single argument of type <xref:System.Data.Services.IDataServiceConfiguration>. The configuration object may only be used during the call to service initialization.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -84,16 +84,16 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets the maximum number of segments that can be expanded by the $expand query option for all requests to the data service.</summary>
+        <summary>Gets or sets the maximum number of segments that can be expanded by the <see langword="$expand" /> query option for all requests to the data service.</summary>
         <value>The maximum number of segments to expand.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If the limit is exceeded, a 400 Bad Request status code is returned. The value specified must be between 0 and `int.MaxValue`; otherwise, an `ArgumentOutOfRangeException` is thrown.  
-  
- The following query string sample has two segments:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ If the limit is exceeded, a 400 Bad Request status code is returned. The value specified must be between 0 and `int.MaxValue`; otherwise, an `ArgumentOutOfRangeException` is thrown.
+
+ The following query string sample has two segments:
+
  ]]></format>
         </remarks>
       </Docs>
@@ -118,13 +118,13 @@
         <summary>Gets or sets a maximum number of segments supported in a single <c>$expand</c> path for all requests to the data service.</summary>
         <value>Integer representing the maximum number of supported segments in <c>$expand</c> path.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If the limit is exceeded, a 400 Bad Request status code is returned. The value specified must be between 0 and `int.MaxValue`; otherwise, an `ArgumentOutOfRangeException` is thrown.  
-  
- The following query string sample has two segments in the first `$expand` path and one in the second `$expand` path:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ If the limit is exceeded, a 400 Bad Request status code is returned. The value specified must be between 0 and `int.MaxValue`; otherwise, an `ArgumentOutOfRangeException` is thrown.
+
+ The following query string sample has two segments in the first `$expand` path and one in the second `$expand` path:
+
  ]]></format>
         </remarks>
       </Docs>
@@ -223,11 +223,11 @@
         <param name="rights">The rights allowed for the entity set.</param>
         <summary>Sets the access rules for the specified entity set.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The default configuration is to deny access to resources. When a service is initialized the access rights must be enabled.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The default configuration is to deny access to resources. When a service is initialized the access rights must be enabled.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -257,11 +257,11 @@
         <param name="rights">The rights allowed according to <see cref="T:System.Data.Services.ServiceOperationRights" /> enumeration.</param>
         <summary>Sets the access rules for the specified service operation.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The default configuration is to deny access to resources. When a service is initialized, the access rights must be enabled.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The default configuration is to deny access to resources. When a service is initialized, the access rights must be enabled.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -286,11 +286,11 @@
         <summary>Gets or sets whether verbose errors are used by default for all responses from the data service.</summary>
         <value>A Boolean value that indicates whether verbose errors are returned.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The response from a specified request can be overridden by the data service developer by overriding the `HandleException` method. Verbose errors should only be enabled during development, not in production environments, for security reasons.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The response from a specified request can be overridden by the data service developer by overriding the `HandleException` method. Verbose errors should only be enabled during development, not in production environments, for security reasons.
+
  ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Diagnostics/EventLogInstaller.xml b/xml/System.Diagnostics/EventLogInstaller.xml
index 9bbb7b3cf6b..0127fb3f5d0 100644
--- a/xml/System.Diagnostics/EventLogInstaller.xml
+++ b/xml/System.Diagnostics/EventLogInstaller.xml
@@ -18,47 +18,47 @@
   <Docs>
     <summary>Allows you to install and configure an event log that your application reads from or writes to when running.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Diagnostics.EventLogInstaller> is used by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) when installing an event log. The <xref:System.Diagnostics.EventLogInstaller> class can install event logs only on the local computer.  
-  
- Use the <xref:System.Diagnostics.EventLogInstaller> class when your application writes to an event log; it is not necessary to use an event log installer for your application to read from an event log. Applications and services should write to the Application log or a custom log. Device drivers should write to the System log.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Diagnostics.EventLogInstaller> is used by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) when installing an event log. The <xref:System.Diagnostics.EventLogInstaller> class can install event logs only on the local computer.
+
+ Use the <xref:System.Diagnostics.EventLogInstaller> class when your application writes to an event log; it is not necessary to use an event log installer for your application to read from an event log. Applications and services should write to the Application log or a custom log. Device drivers should write to the System log.
+
 > [!NOTE]
->  The Security log is read-only.  
-  
- The installer creates the event source that you specify in the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property and registers it for the event log specified in <xref:System.Diagnostics.EventLogInstaller.Log%2A> property. This behavior is similar to calling <xref:System.Diagnostics.EventLog.CreateEventSource%2A> on the <xref:System.Diagnostics.EventLog> component.  
-  
- Use the <xref:System.Diagnostics.EventLog.WriteEvent%2A> and <xref:System.Diagnostics.EventLog.WriteEntry%2A> methods to write events to an event log. You must specify an event source to write events; you must create and configure the event source before writing the first entry with the source.  
-  
- Create the new event source during the installation of your application. This allows time for the operating system to refresh its list of registered event sources and their configurations. If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. You can configure a new source using an <xref:System.Diagnostics.EventLogInstaller>, or using the <xref:System.Diagnostics.EventLog.CreateEventSource%2A> method. You must have administrative rights on the computer to create a new event source.  
-  
- You can create an event source for an existing event log or a new event log. When you create a new source for a new event log, the system registers the source for that log, but the log is not created until the first entry is written to it.  
-  
- To install an event log, create a project installer class that inherits from <xref:System.Configuration.Install.Installer>, and set the <xref:System.ComponentModel.RunInstallerAttribute> for the class to `true`. Within your project, create an <xref:System.Diagnostics.EventLogInstaller> for each event log that your application will write to and add the instance to your project installer class.  
-  
- When the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) is called, it looks at the <xref:System.ComponentModel.RunInstallerAttribute>. If it is `true`, the tool installs all the items in the <xref:System.Configuration.Install.Installer.Installers%2A> collection that are associated with your project installer. If <xref:System.ComponentModel.RunInstallerAttribute> is `false`, the tool ignores the project installer.  
-  
- You modify other properties of an <xref:System.Diagnostics.EventLogInstaller> either before or after adding the instance to the <xref:System.Configuration.Install.Installer.Installers%2A> collection of your project installer, but before the installer tool runs. You must set the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property if your application will be writing to the event log.  
-  
- Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method does not register the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.  
-  
- You can register the event source with localized resource files for your event category and message strings. Your application can write event log entries using resource identifiers, rather than specifying the actual string. The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings. You can register a separate file for event categories, messages, and parameter insertion strings, or you can register the same resource file for all three types of strings. Use the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A>, <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A>, <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A>, and <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> properties to configure the source to write localized entries to the event log. If your application writes strings values directly to the event log, you do not need to set these properties.  
-  
- The source must be configured either for writing localized entries or for writing direct strings. If your application writes entries using both resource identifiers and string values, you must register two separate sources. For example, configure one source with resource files, and then use that source in the <xref:System.Diagnostics.EventLog.WriteEvent%2A> method to write entries using resource identifiers to the event log. Create a different source without resource files and then use that source in the <xref:System.Diagnostics.EventLog.WriteEntry%2A> method to write strings directly to the event log using that source.  
-  
- Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> class from within your code; they are generally called only by Installutil.exe. The tool automatically calls the <xref:System.Diagnostics.EventLogInstaller.Install%2A> method during the installation process. It backs out failures, if necessary, by calling the <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method for the object that generated the exception.  
-  
-   
-  
-## Examples  
- The following code example sets the installation properties for a new event source. The code example sets the source name and the event log name, and adds the <xref:System.Diagnostics.EventLogInstaller> to the <xref:System.Configuration.Install.Installer.Installers%2A> collection.  
-  
+>  The Security log is read-only.
+
+ The installer creates the event source that you specify in the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property and registers it for the event log specified in <xref:System.Diagnostics.EventLogInstaller.Log%2A> property. This behavior is similar to calling <xref:System.Diagnostics.EventLog.CreateEventSource%2A> on the <xref:System.Diagnostics.EventLog> component.
+
+ Use the <xref:System.Diagnostics.EventLog.WriteEvent%2A> and <xref:System.Diagnostics.EventLog.WriteEntry%2A> methods to write events to an event log. You must specify an event source to write events; you must create and configure the event source before writing the first entry with the source.
+
+ Create the new event source during the installation of your application. This allows time for the operating system to refresh its list of registered event sources and their configurations. If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. You can configure a new source using an <xref:System.Diagnostics.EventLogInstaller>, or using the <xref:System.Diagnostics.EventLog.CreateEventSource%2A> method. You must have administrative rights on the computer to create a new event source.
+
+ You can create an event source for an existing event log or a new event log. When you create a new source for a new event log, the system registers the source for that log, but the log is not created until the first entry is written to it.
+
+ To install an event log, create a project installer class that inherits from <xref:System.Configuration.Install.Installer>, and set the <xref:System.ComponentModel.RunInstallerAttribute> for the class to `true`. Within your project, create an <xref:System.Diagnostics.EventLogInstaller> for each event log that your application will write to and add the instance to your project installer class.
+
+ When the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) is called, it looks at the <xref:System.ComponentModel.RunInstallerAttribute>. If it is `true`, the tool installs all the items in the <xref:System.Configuration.Install.Installer.Installers%2A> collection that are associated with your project installer. If <xref:System.ComponentModel.RunInstallerAttribute> is `false`, the tool ignores the project installer.
+
+ You modify other properties of an <xref:System.Diagnostics.EventLogInstaller> either before or after adding the instance to the <xref:System.Configuration.Install.Installer.Installers%2A> collection of your project installer, but before the installer tool runs. You must set the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property if your application will be writing to the event log.
+
+ Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method does not register the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.
+
+ You can register the event source with localized resource files for your event category and message strings. Your application can write event log entries using resource identifiers, rather than specifying the actual string. The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings. You can register a separate file for event categories, messages, and parameter insertion strings, or you can register the same resource file for all three types of strings. Use the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A>, <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A>, <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A>, and <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> properties to configure the source to write localized entries to the event log. If your application writes strings values directly to the event log, you do not need to set these properties.
+
+ The source must be configured either for writing localized entries or for writing direct strings. If your application writes entries using both resource identifiers and string values, you must register two separate sources. For example, configure one source with resource files, and then use that source in the <xref:System.Diagnostics.EventLog.WriteEvent%2A> method to write entries using resource identifiers to the event log. Create a different source without resource files and then use that source in the <xref:System.Diagnostics.EventLog.WriteEntry%2A> method to write strings directly to the event log using that source.
+
+ Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> class from within your code; they are generally called only by Installutil.exe. The tool automatically calls the <xref:System.Diagnostics.EventLogInstaller.Install%2A> method during the installation process. It backs out failures, if necessary, by calling the <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method for the object that generated the exception.
+
+
+
+## Examples
+ The following code example sets the installation properties for a new event source. The code example sets the source name and the event log name, and adds the <xref:System.Diagnostics.EventLogInstaller> to the <xref:System.Configuration.Install.Installer.Installers%2A> collection.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/EventLogInstaller/CPP/eventloginstaller.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics/EventLogInstaller/Overview/eventloginstaller.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/EventLogInstaller/VB/eventloginstaller.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/EventLogInstaller/VB/eventloginstaller.vb" id="Snippet1":::
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.Diagnostics.EventLog" />
@@ -111,137 +111,137 @@
         <summary>Gets or sets the number of categories in the category resource file.</summary>
         <value>The number of categories in the category resource file. The default value is zero.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties to write events with localized category strings. The Event Viewer displays the category for an event entry, if you supply a category when you write the event. Event log categories are application-defined strings that help filter events, or provide information on an event. For example, your application can define separate categories for different components or different operations.  
-  
- Event categories are optional; if your application does not use categories, do not set the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties.  
-  
- For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.  
-  
-   
-  
-## Examples  
- The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties to write events with localized category strings. The Event Viewer displays the category for an event entry, if you supply a category when you write the event. Event log categories are application-defined strings that help filter events, or provide information on an event. For example, your application can define separate categories for different components or different operations.
+
+ Event categories are optional; if your application does not use categories, do not set the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties.
+
+ For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.
+
+
+
+## Examples
+ The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/eventlogInstaller_Resources/CPP/source.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics/EventLogInstaller/CategoryCount/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::  
-  
- The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings.  
-  
-```  
-; // EventLogMsgs.mc  
-; // ********************************************************  
-  
-; // Use the following commands to build this file:  
-  
-; //   mc -s EventLogMsgs.mc  
-; //   rc EventLogMsgs.rc  
-; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res   
-; // ********************************************************  
-  
-; // - Event categories -  
-; // Categories must be numbered consecutively starting at 1.  
-; // ********************************************************  
-  
-MessageId=0x1  
-Severity=Success  
-SymbolicName=INSTALL_CATEGORY  
-Language=English  
-Installation  
-.  
-  
-MessageId=0x2  
-Severity=Success  
-SymbolicName=QUERY_CATEGORY  
-Language=English  
-Database Query  
-.  
-  
-MessageId=0x3  
-Severity=Success  
-SymbolicName=REFRESH_CATEGORY  
-Language=English  
-Data Refresh  
-.  
-  
-; // - Event messages -  
-; // *********************************  
-  
-MessageId = 1000  
-Severity = Success  
-Facility = Application  
-SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000  
-Language=English  
-My application message text, in English, for message id 1000, called from %1.  
-.  
-  
-MessageId = 1001  
-Severity = Warning  
-Facility = Application  
-SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001  
-Language=English  
-My application message text, in English, for message id 1001, called from %1.  
-.  
-  
-MessageId = 1002  
-Severity = Success  
-Facility = Application  
-SymbolicName = GENERIC_INFO_MESSAGE_ID_1002  
-Language=English  
-My generic information message in English, for message id 1002.  
-.  
-  
-MessageId = 1003  
-Severity = Warning  
-Facility = Application  
-SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003  
-Language=English  
-My generic warning message in English, for message id 1003, called from %1.  
-.  
-  
-MessageId = 1004  
-Severity = Success  
-Facility = Application  
-SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004  
-Language=English  
-The update cycle is complete for %%5002.  
-.  
-  
-MessageId = 1005  
-Severity = Warning  
-Facility = Application  
-SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005  
-Language=English  
-The refresh operation did not complete because the connection to server %1 could not be established.  
-.  
-  
-; // - Event log display name -  
-; // ********************************************************  
-  
-MessageId = 5001  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID  
-Language=English  
-Sample Event Log  
-.  
-  
-; // - Event message parameters -  
-; //   Language independent insertion strings  
-; // ********************************************************  
-  
-MessageId = 5002  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID  
-Language=English  
-SVC_UPDATE.EXE  
-.  
-```  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::
+
+ The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings.
+
+```
+; // EventLogMsgs.mc
+; // ********************************************************
+
+; // Use the following commands to build this file:
+
+; //   mc -s EventLogMsgs.mc
+; //   rc EventLogMsgs.rc
+; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res
+; // ********************************************************
+
+; // - Event categories -
+; // Categories must be numbered consecutively starting at 1.
+; // ********************************************************
+
+MessageId=0x1
+Severity=Success
+SymbolicName=INSTALL_CATEGORY
+Language=English
+Installation
+.
+
+MessageId=0x2
+Severity=Success
+SymbolicName=QUERY_CATEGORY
+Language=English
+Database Query
+.
+
+MessageId=0x3
+Severity=Success
+SymbolicName=REFRESH_CATEGORY
+Language=English
+Data Refresh
+.
+
+; // - Event messages -
+; // *********************************
+
+MessageId = 1000
+Severity = Success
+Facility = Application
+SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
+Language=English
+My application message text, in English, for message id 1000, called from %1.
+.
+
+MessageId = 1001
+Severity = Warning
+Facility = Application
+SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
+Language=English
+My application message text, in English, for message id 1001, called from %1.
+.
+
+MessageId = 1002
+Severity = Success
+Facility = Application
+SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
+Language=English
+My generic information message in English, for message id 1002.
+.
+
+MessageId = 1003
+Severity = Warning
+Facility = Application
+SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
+Language=English
+My generic warning message in English, for message id 1003, called from %1.
+.
+
+MessageId = 1004
+Severity = Success
+Facility = Application
+SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
+Language=English
+The update cycle is complete for %%5002.
+.
+
+MessageId = 1005
+Severity = Warning
+Facility = Application
+SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
+Language=English
+The refresh operation did not complete because the connection to server %1 could not be established.
+.
+
+; // - Event log display name -
+; // ********************************************************
+
+MessageId = 5001
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
+Language=English
+Sample Event Log
+.
+
+; // - Event message parameters -
+; //   Language independent insertion strings
+; // ********************************************************
+
+MessageId = 5002
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
+Language=English
+SVC_UPDATE.EXE
+.
+```
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Diagnostics.EventLogInstaller.CategoryResourceFile" />
@@ -291,137 +291,137 @@ SVC_UPDATE.EXE
         <summary>Gets or sets the path of the resource file that contains category strings for the source.</summary>
         <value>The path of the category resource file. The default is an empty string ("").</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties to write events with localized category strings. The Event Viewer displays the category for an event entry if you supply a category when you write the event. Event log categories are application-defined strings that help filter events, or provide information about an event. For example, your application might have separate categories for different components or different operations.  
-  
- Event categories are optional; if your application does not use categories, do not set the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties.  
-  
- For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.  
-  
-   
-  
-## Examples  
- The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties to write events with localized category strings. The Event Viewer displays the category for an event entry if you supply a category when you write the event. Event log categories are application-defined strings that help filter events, or provide information about an event. For example, your application might have separate categories for different components or different operations.
+
+ Event categories are optional; if your application does not use categories, do not set the <xref:System.Diagnostics.EventLogInstaller.CategoryCount%2A> and <xref:System.Diagnostics.EventLogInstaller.CategoryResourceFile%2A> properties.
+
+ For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.
+
+
+
+## Examples
+ The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/eventlogInstaller_Resources/CPP/source.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics/EventLogInstaller/CategoryCount/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::  
-  
- The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings.  
-  
-```  
-; // EventLogMsgs.mc  
-; // ********************************************************  
-  
-; // Use the following commands to build this file:  
-  
-; //   mc -s EventLogMsgs.mc  
-; //   rc EventLogMsgs.rc  
-; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res   
-; // ********************************************************  
-  
-; // - Event categories -  
-; // Categories must be numbered consecutively starting at 1.  
-; // ********************************************************  
-  
-MessageId=0x1  
-Severity=Success  
-SymbolicName=INSTALL_CATEGORY  
-Language=English  
-Installation  
-.  
-  
-MessageId=0x2  
-Severity=Success  
-SymbolicName=QUERY_CATEGORY  
-Language=English  
-Database Query  
-.  
-  
-MessageId=0x3  
-Severity=Success  
-SymbolicName=REFRESH_CATEGORY  
-Language=English  
-Data Refresh  
-.  
-  
-; // - Event messages -  
-; // *********************************  
-  
-MessageId = 1000  
-Severity = Success  
-Facility = Application  
-SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000  
-Language=English  
-My application message text, in English, for message id 1000, called from %1.  
-.  
-  
-MessageId = 1001  
-Severity = Warning  
-Facility = Application  
-SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001  
-Language=English  
-My application message text, in English, for message id 1001, called from %1.  
-.  
-  
-MessageId = 1002  
-Severity = Success  
-Facility = Application  
-SymbolicName = GENERIC_INFO_MESSAGE_ID_1002  
-Language=English  
-My generic information message in English, for message id 1002.  
-.  
-  
-MessageId = 1003  
-Severity = Warning  
-Facility = Application  
-SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003  
-Language=English  
-My generic warning message in English, for message id 1003, called from %1.  
-.  
-  
-MessageId = 1004  
-Severity = Success  
-Facility = Application  
-SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004  
-Language=English  
-The update cycle is complete for %%5002.  
-.  
-  
-MessageId = 1005  
-Severity = Warning  
-Facility = Application  
-SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005  
-Language=English  
-The refresh operation did not complete because the connection to server %1 could not be established.  
-.  
-  
-; // - Event log display name -  
-; // ********************************************************  
-  
-MessageId = 5001  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID  
-Language=English  
-Sample Event Log  
-.  
-  
-; // - Event message parameters -  
-; //   Language independent insertion strings  
-; // ********************************************************  
-  
-MessageId = 5002  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID  
-Language=English  
-SVC_UPDATE.EXE  
-.  
-```  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::
+
+ The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings.
+
+```
+; // EventLogMsgs.mc
+; // ********************************************************
+
+; // Use the following commands to build this file:
+
+; //   mc -s EventLogMsgs.mc
+; //   rc EventLogMsgs.rc
+; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res
+; // ********************************************************
+
+; // - Event categories -
+; // Categories must be numbered consecutively starting at 1.
+; // ********************************************************
+
+MessageId=0x1
+Severity=Success
+SymbolicName=INSTALL_CATEGORY
+Language=English
+Installation
+.
+
+MessageId=0x2
+Severity=Success
+SymbolicName=QUERY_CATEGORY
+Language=English
+Database Query
+.
+
+MessageId=0x3
+Severity=Success
+SymbolicName=REFRESH_CATEGORY
+Language=English
+Data Refresh
+.
+
+; // - Event messages -
+; // *********************************
+
+MessageId = 1000
+Severity = Success
+Facility = Application
+SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
+Language=English
+My application message text, in English, for message id 1000, called from %1.
+.
+
+MessageId = 1001
+Severity = Warning
+Facility = Application
+SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
+Language=English
+My application message text, in English, for message id 1001, called from %1.
+.
+
+MessageId = 1002
+Severity = Success
+Facility = Application
+SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
+Language=English
+My generic information message in English, for message id 1002.
+.
+
+MessageId = 1003
+Severity = Warning
+Facility = Application
+SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
+Language=English
+My generic warning message in English, for message id 1003, called from %1.
+.
+
+MessageId = 1004
+Severity = Success
+Facility = Application
+SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
+Language=English
+The update cycle is complete for %%5002.
+.
+
+MessageId = 1005
+Severity = Warning
+Facility = Application
+SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
+Language=English
+The refresh operation did not complete because the connection to server %1 could not be established.
+.
+
+; // - Event log display name -
+; // ********************************************************
+
+MessageId = 5001
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
+Language=English
+Sample Event Log
+.
+
+; // - Event message parameters -
+; //   Language independent insertion strings
+; // ********************************************************
+
+MessageId = 5002
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
+Language=English
+SVC_UPDATE.EXE
+.
+```
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Diagnostics.EventLogInstaller.CategoryCount" />
@@ -453,21 +453,21 @@ SVC_UPDATE.EXE
         <param name="component">An <see cref="T:System.ComponentModel.IComponent" /> to use as a template for the <see cref="T:System.Diagnostics.EventLogInstaller" />.</param>
         <summary>Copies the property values of an <see cref="T:System.Diagnostics.EventLog" /> component that are required at installation time for an event log.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The component specified by the `component` parameter must be an <xref:System.Diagnostics.EventLog>; otherwise, an exception is thrown.  
-  
- Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). <xref:System.Diagnostics.EventLogInstaller.CopyFromComponent%2A> is used by Installutil.exe to set the property values for the <xref:System.Diagnostics.EventLogInstaller> to the values of an existing <xref:System.Diagnostics.EventLog>.  
-  
- If the <xref:System.Diagnostics.EventLog.Log%2A> of the <xref:System.Diagnostics.EventLog> that is passed in is an empty string (""), you must set the <xref:System.Diagnostics.EventLog.Log%2A> property to a valid value before the installer executes.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The component specified by the `component` parameter must be an <xref:System.Diagnostics.EventLog>; otherwise, an exception is thrown.
+
+ Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). <xref:System.Diagnostics.EventLogInstaller.CopyFromComponent%2A> is used by Installutil.exe to set the property values for the <xref:System.Diagnostics.EventLogInstaller> to the values of an existing <xref:System.Diagnostics.EventLog>.
+
+ If the <xref:System.Diagnostics.EventLog.Log%2A> of the <xref:System.Diagnostics.EventLog> that is passed in is an empty string (""), you must set the <xref:System.Diagnostics.EventLog.Log%2A> property to a valid value before the installer executes.
+
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">The specified component is not an <see cref="T:System.Diagnostics.EventLog" />.  
-  
- -or-  
-  
+        <exception cref="T:System.ArgumentException">The specified component is not an <see cref="T:System.Diagnostics.EventLog" />.
+
+ -or-
+
  The <see cref="P:System.Diagnostics.EventLog.Log" /> or <see cref="P:System.Diagnostics.EventLog.Source" /> property of the specified component is either <see langword="null" /> or empty.</exception>
       </Docs>
     </Member>
@@ -495,17 +495,17 @@ SVC_UPDATE.EXE
         <param name="stateSaver">An <see cref="T:System.Collections.IDictionary" /> used to save information needed to perform a rollback or uninstall operation.</param>
         <summary>Performs the installation and writes event log information to the registry.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method writes event log information to the registry, and associates the event log with a log that is specified by the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property. If the log does not already exist (and a source is specified), <xref:System.Diagnostics.EventLogInstaller.Install%2A> creates a log and associates the new source with it.  
-  
- Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). The tool automatically calls the <xref:System.Diagnostics.EventLogInstaller.Install%2A> method during the installation process to write registry information that is associated with the event log being installed. Installation is transactional, so if there is a failure of any installation project component during the installation, all the previously-installed components are rolled back to their pre-installation states. This is accomplished by calling each component's <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method.  
-  
- Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method skips registering the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.  
-  
- An application's install routine uses the project installer's <xref:System.Configuration.Install.Installer.Context%2A?displayProperty=nameWithType> property to automatically maintain information about the components that have already been installed. This state information, which is passed to <xref:System.Diagnostics.EventLogInstaller.Install%2A> as the `stateSaver` parameter, is continuously updated as the tool installs each <xref:System.Diagnostics.EventLogInstaller>. Usually, it is not necessary for your code to explicitly modify this state information.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method writes event log information to the registry, and associates the event log with a log that is specified by the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property. If the log does not already exist (and a source is specified), <xref:System.Diagnostics.EventLogInstaller.Install%2A> creates a log and associates the new source with it.
+
+ Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). The tool automatically calls the <xref:System.Diagnostics.EventLogInstaller.Install%2A> method during the installation process to write registry information that is associated with the event log being installed. Installation is transactional, so if there is a failure of any installation project component during the installation, all the previously-installed components are rolled back to their pre-installation states. This is accomplished by calling each component's <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method.
+
+ Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method skips registering the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.
+
+ An application's install routine uses the project installer's <xref:System.Configuration.Install.Installer.Context%2A?displayProperty=nameWithType> property to automatically maintain information about the components that have already been installed. This state information, which is passed to <xref:System.Diagnostics.EventLogInstaller.Install%2A> as the `stateSaver` parameter, is continuously updated as the tool installs each <xref:System.Diagnostics.EventLogInstaller>. Usually, it is not necessary for your code to explicitly modify this state information.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">The name specified in the <see cref="P:System.Diagnostics.EventLogInstaller.Source" /> property is already registered for a different event log.</exception>
@@ -540,11 +540,11 @@ SVC_UPDATE.EXE
         <returns>
           <see langword="true" /> if this installer and the installer specified by the <paramref name="otherInstaller" /> parameter would install or uninstall the same source; otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the Installer tool (Installutil.exe).  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the Installer tool (Installutil.exe).
+
  ]]></format>
         </remarks>
         <altmember cref="M:System.Diagnostics.EventLogInstaller.CopyFromComponent(System.ComponentModel.IComponent)" />
@@ -585,19 +585,19 @@ SVC_UPDATE.EXE
         <summary>Gets or sets the name of the log to set the source to.</summary>
         <value>The name of the log. This can be Application, System, or a custom log name. The default is an empty string ("").</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- You can use the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property to associate the source you specify in the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property with either an existing log or a new log on the local computer. The [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) uses this information to map the source to the log in the computer's registry. Applications and services should write to the Application log or a custom log. Device drivers should write to the System log.  
-  
- To write entries to an event log, you must create a source and register it with an event log. An event source can only write to one log at a time. The installer uses the value of the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property to register your application with the event log as a valid source of entries. If you do not specify a log name before the installer runs, the installer registers your source to the Application log. If you specify a new source and an existing log, the installer creates a new event source and associates it with the log you specify. If you specify both a new source and a new log, the installer associates the new source with the new log in the registry, but the log is not created until the first entry is written to it.  
-  
- The operating system stores event logs as files. When you use <xref:System.Diagnostics.EventLogInstaller> or the <xref:System.Diagnostics.EventLog.CreateEventSource%2A> method to create a new event log, the associated file is stored in the %SystemRoot%\System32\Config directory on the specified computer. The file name is set by appending the first 8 characters of the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property with the ".evt" file name extension.  
-  
- Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method does not register the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.  
-  
- For more detailed information about the behaviors of event logs and sources, see the <xref:System.Diagnostics.EventLog> class documentation for the <xref:System.Diagnostics.EventLog.Log%2A> and <xref:System.Diagnostics.EventLog.Source%2A> properties.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ You can use the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property to associate the source you specify in the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property with either an existing log or a new log on the local computer. The [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) uses this information to map the source to the log in the computer's registry. Applications and services should write to the Application log or a custom log. Device drivers should write to the System log.
+
+ To write entries to an event log, you must create a source and register it with an event log. An event source can only write to one log at a time. The installer uses the value of the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property to register your application with the event log as a valid source of entries. If you do not specify a log name before the installer runs, the installer registers your source to the Application log. If you specify a new source and an existing log, the installer creates a new event source and associates it with the log you specify. If you specify both a new source and a new log, the installer associates the new source with the new log in the registry, but the log is not created until the first entry is written to it.
+
+ The operating system stores event logs as files. When you use <xref:System.Diagnostics.EventLogInstaller> or the <xref:System.Diagnostics.EventLog.CreateEventSource%2A> method to create a new event log, the associated file is stored in the %SystemRoot%\System32\Config directory on the specified computer. The file name is set by appending the first 8 characters of the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property with the ".evt" file name extension.
+
+ Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method does not register the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.
+
+ For more detailed information about the behaviors of event logs and sources, see the <xref:System.Diagnostics.EventLog> class documentation for the <xref:System.Diagnostics.EventLog.Log%2A> and <xref:System.Diagnostics.EventLog.Source%2A> properties.
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Diagnostics.EventLog.Log" />
@@ -646,143 +646,141 @@ SVC_UPDATE.EXE
         <summary>Gets or sets the path of the resource file that contains message formatting strings for the source.</summary>
         <value>The path of the message resource file. The default is an empty string ("").</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property to configure an event log source to write localized event messages. Event messages are application-defined strings that describe the event to the user.  
-  
- Your application can write event log entries using resource identifiers. A resource identifier indexes a message located in the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A>. The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings.  
-  
- The event source must be configured either for writing localized entries or for writing direct strings. Use the <xref:System.Diagnostics.EventLog.WriteEvent%2A> method to write localized entries for a source configured with a message resource file.  
-  
- If your application writes event message strings directly, rather than using a resource identifier in a localized resource file, do not set the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property.  
-  
- If the <xref:System.Diagnostics.EventLog.MachineName%2A> property is not the local computer identifier ("."), the .NET Framework assumes that the resource file is on a remote computer. If the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property value contains a drive letter, the resource file is assumed to be on the \\\\<machinename\>\\<drive\>$ share (for example, \\\server\c$). If the value contains the string %systemroot%, the resource file is assumed to be on the \\\\<machinename\>\admin$ share (for example, \\\server\admin$).  
-  
- For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.  
-  
-   
-  
-## Examples  
- The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property to configure an event log source to write localized event messages. Event messages are application-defined strings that describe the event to the user.
+
+ Your application can write event log entries using resource identifiers. A resource identifier indexes a message located in the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A>. The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings.
+
+ The event source must be configured either for writing localized entries or for writing direct strings. Use the <xref:System.Diagnostics.EventLog.WriteEvent%2A> method to write localized entries for a source configured with a message resource file.
+
+ If your application writes event message strings directly, rather than using a resource identifier in a localized resource file, do not set the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property.
+
+ If the <xref:System.Diagnostics.EventLog.MachineName%2A> property is not the local computer identifier ("."), the .NET Framework assumes that the resource file is on a remote computer. If the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property value contains a drive letter, the resource file is assumed to be on the \\\\<machinename\>\\<drive\>\\$ share (for example, \\\server\c\\$). If the value contains the string %systemroot%, the resource file is assumed to be on the \\\\<machinename\>\admin\\$ share (for example, \\\server\admin\\$).
+
+ For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.
+
+## Examples
+ The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/eventlogInstaller_Resources/CPP/source.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics/EventLogInstaller/CategoryCount/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::  
-  
- The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings.  
-  
-```  
-; // EventLogMsgs.mc  
-; // ********************************************************  
-  
-; // Use the following commands to build this file:  
-  
-; //   mc -s EventLogMsgs.mc  
-; //   rc EventLogMsgs.rc  
-; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res   
-; // ********************************************************  
-  
-; // - Event categories -  
-; // Categories must be numbered consecutively starting at 1.  
-; // ********************************************************  
-  
-MessageId=0x1  
-Severity=Success  
-SymbolicName=INSTALL_CATEGORY  
-Language=English  
-Installation  
-.  
-  
-MessageId=0x2  
-Severity=Success  
-SymbolicName=QUERY_CATEGORY  
-Language=English  
-Database Query  
-.  
-  
-MessageId=0x3  
-Severity=Success  
-SymbolicName=REFRESH_CATEGORY  
-Language=English  
-Data Refresh  
-.  
-  
-; // - Event messages -  
-; // *********************************  
-  
-MessageId = 1000  
-Severity = Success  
-Facility = Application  
-SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000  
-Language=English  
-My application message text, in English, for message id 1000, called from %1.  
-.  
-  
-MessageId = 1001  
-Severity = Warning  
-Facility = Application  
-SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001  
-Language=English  
-My application message text, in English, for message id 1001, called from %1.  
-.  
-  
-MessageId = 1002  
-Severity = Success  
-Facility = Application  
-SymbolicName = GENERIC_INFO_MESSAGE_ID_1002  
-Language=English  
-My generic information message in English, for message id 1002.  
-.  
-  
-MessageId = 1003  
-Severity = Warning  
-Facility = Application  
-SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003  
-Language=English  
-My generic warning message in English, for message id 1003, called from %1.  
-.  
-  
-MessageId = 1004  
-Severity = Success  
-Facility = Application  
-SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004  
-Language=English  
-The update cycle is complete for %%5002.  
-.  
-  
-MessageId = 1005  
-Severity = Warning  
-Facility = Application  
-SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005  
-Language=English  
-The refresh operation did not complete because the connection to server %1 could not be established.  
-.  
-  
-; // - Event log display name -  
-; // ********************************************************  
-  
-MessageId = 5001  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID  
-Language=English  
-Sample Event Log  
-.  
-  
-; // - Event message parameters -  
-; //   Language independent insertion strings  
-; // ********************************************************  
-  
-MessageId = 5002  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID  
-Language=English  
-SVC_UPDATE.EXE  
-.  
-```  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::
+
+ The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings.
+
+```
+; // EventLogMsgs.mc
+; // ********************************************************
+
+; // Use the following commands to build this file:
+
+; //   mc -s EventLogMsgs.mc
+; //   rc EventLogMsgs.rc
+; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res
+; // ********************************************************
+
+; // - Event categories -
+; // Categories must be numbered consecutively starting at 1.
+; // ********************************************************
+
+MessageId=0x1
+Severity=Success
+SymbolicName=INSTALL_CATEGORY
+Language=English
+Installation
+.
+
+MessageId=0x2
+Severity=Success
+SymbolicName=QUERY_CATEGORY
+Language=English
+Database Query
+.
+
+MessageId=0x3
+Severity=Success
+SymbolicName=REFRESH_CATEGORY
+Language=English
+Data Refresh
+.
+
+; // - Event messages -
+; // *********************************
+
+MessageId = 1000
+Severity = Success
+Facility = Application
+SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
+Language=English
+My application message text, in English, for message id 1000, called from %1.
+.
+
+MessageId = 1001
+Severity = Warning
+Facility = Application
+SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
+Language=English
+My application message text, in English, for message id 1001, called from %1.
+.
+
+MessageId = 1002
+Severity = Success
+Facility = Application
+SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
+Language=English
+My generic information message in English, for message id 1002.
+.
+
+MessageId = 1003
+Severity = Warning
+Facility = Application
+SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
+Language=English
+My generic warning message in English, for message id 1003, called from %1.
+.
+
+MessageId = 1004
+Severity = Success
+Facility = Application
+SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
+Language=English
+The update cycle is complete for %%5002.
+.
+
+MessageId = 1005
+Severity = Warning
+Facility = Application
+SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
+Language=English
+The refresh operation did not complete because the connection to server %1 could not be established.
+.
+
+; // - Event log display name -
+; // ********************************************************
+
+MessageId = 5001
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
+Language=English
+Sample Event Log
+.
+
+; // - Event message parameters -
+; //   Language independent insertion strings
+; // ********************************************************
+
+MessageId = 5002
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
+Language=English
+SVC_UPDATE.EXE
+.
+```
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Diagnostics.EventSourceCreationData.MessageResourceFile" />
@@ -830,164 +828,164 @@ SVC_UPDATE.EXE
         <summary>Gets or sets the path of the resource file that contains message parameter strings for the source.</summary>
         <value>The path of the message parameter resource file. The default is an empty string ("").</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> property to configure an event log source to write localized event messages with inserted parameter strings. Each localized event message specified in the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property can contain placeholders for insertion strings. These placeholders are used to specify the position and resource identifier for a language-independent string within the event message. The Event Viewer replaces the placeholders with the corresponding strings from the <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> and formats the event log message for the localized event entry.  
-  
- For example, the following section of a message text file defines a string with a parameter placeholder:  
-  
-```  
-  
-MessageId = 1501  
-Severity = Success  
-Facility = Application  
-SymbolicName = COMPONENT_STARTING  
-Language=English  
-Component %%6050 is starting.  
-.  
-```  
-  
- Within the parameter resource file, the insertion string must be defined with the resource identifier that corresponds to the placeholder, as shown below:  
-  
-```  
-MessageId = 6050  
-Severity = Success  
-Facility = Application  
-SymbolicName = COMPONENT_NAME_MSGID  
-Language=English  
-TRIGGER.EXE  
-.  
-```  
-  
- The event source must be configured either for writing localized entries or for writing direct strings. Use the <xref:System.Diagnostics.EventLog.WriteEvent%2A> method to write localized entries for a source configured with a message resource file.  
-  
- If your application writes event message strings directly to the event log, or if your <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> does not contain messages with parameter insertion placeholders, do not set the <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> property.  
-  
- For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.  
-  
-   
-  
-## Examples  
- The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> property to configure an event log source to write localized event messages with inserted parameter strings. Each localized event message specified in the <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> property can contain placeholders for insertion strings. These placeholders are used to specify the position and resource identifier for a language-independent string within the event message. The Event Viewer replaces the placeholders with the corresponding strings from the <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> and formats the event log message for the localized event entry.
+
+ For example, the following section of a message text file defines a string with a parameter placeholder:
+
+```
+
+MessageId = 1501
+Severity = Success
+Facility = Application
+SymbolicName = COMPONENT_STARTING
+Language=English
+Component %%6050 is starting.
+.
+```
+
+ Within the parameter resource file, the insertion string must be defined with the resource identifier that corresponds to the placeholder, as shown below:
+
+```
+MessageId = 6050
+Severity = Success
+Facility = Application
+SymbolicName = COMPONENT_NAME_MSGID
+Language=English
+TRIGGER.EXE
+.
+```
+
+ The event source must be configured either for writing localized entries or for writing direct strings. Use the <xref:System.Diagnostics.EventLog.WriteEvent%2A> method to write localized entries for a source configured with a message resource file.
+
+ If your application writes event message strings directly to the event log, or if your <xref:System.Diagnostics.EventLogInstaller.MessageResourceFile%2A> does not contain messages with parameter insertion placeholders, do not set the <xref:System.Diagnostics.EventLogInstaller.ParameterResourceFile%2A> property.
+
+ For details about defining event messages and building event resource files, see the [Message Compiler](/windows/win32/wes/message-compiler--mc-exe-) article in the Platform SDK documentation.
+
+
+
+## Examples
+ The following code example sets the installation properties for a new event source. The code example sets the event source name, event log name, and resource file for localized event text.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/eventlogInstaller_Resources/CPP/source.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics/EventLogInstaller/CategoryCount/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::  
-  
- The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings. Specifically, the message defined for resource identifier 1004 uses a placeholder for a parameter string defined for resource identifier 5002.  
-  
-```  
-; // EventLogMsgs.mc  
-; // ********************************************************  
-  
-; // Use the following commands to build this file:  
-  
-; //   mc -s EventLogMsgs.mc  
-; //   rc EventLogMsgs.rc  
-; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res   
-; // ********************************************************  
-  
-; // - Event categories -  
-; // Categories must be numbered consecutively starting at 1.  
-; // ********************************************************  
-  
-MessageId=0x1  
-Severity=Success  
-SymbolicName=INSTALL_CATEGORY  
-Language=English  
-Installation  
-.  
-  
-MessageId=0x2  
-Severity=Success  
-SymbolicName=QUERY_CATEGORY  
-Language=English  
-Database Query  
-.  
-  
-MessageId=0x3  
-Severity=Success  
-SymbolicName=REFRESH_CATEGORY  
-Language=English  
-Data Refresh  
-.  
-  
-; // - Event messages -  
-; // *********************************  
-  
-MessageId = 1000  
-Severity = Success  
-Facility = Application  
-SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000  
-Language=English  
-My application message text, in English, for message id 1000, called from %1.  
-.  
-  
-MessageId = 1001  
-Severity = Warning  
-Facility = Application  
-SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001  
-Language=English  
-My application message text, in English, for message id 1001, called from %1.  
-.  
-  
-MessageId = 1002  
-Severity = Success  
-Facility = Application  
-SymbolicName = GENERIC_INFO_MESSAGE_ID_1002  
-Language=English  
-My generic information message in English, for message id 1002.  
-.  
-  
-MessageId = 1003  
-Severity = Warning  
-Facility = Application  
-SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003  
-Language=English  
-My generic warning message in English, for message id 1003, called from %1.  
-.  
-  
-MessageId = 1004  
-Severity = Success  
-Facility = Application  
-SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004  
-Language=English  
-The update cycle is complete for %%5002.  
-.  
-  
-MessageId = 1005  
-Severity = Warning  
-Facility = Application  
-SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005  
-Language=English  
-The refresh operation did not complete because the connection to server %1 could not be established.  
-.  
-  
-; // - Event log display name -  
-; // ********************************************************  
-  
-MessageId = 5001  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID  
-Language=English  
-Sample Event Log  
-.  
-  
-; // - Event message parameters -  
-; //   Language independent insertion strings  
-; // ********************************************************  
-  
-MessageId = 5002  
-Severity = Success  
-Facility = Application  
-SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID  
-Language=English  
-SVC_UPDATE.EXE  
-.  
-```  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/eventlogInstaller_Resources/VB/source.vb" id="Snippet1":::
+
+ The code example uses the following message text file, built into the resource library EventLogMsgs.dll. A message text file is the source from which the message resource file is created. The message text file defines the resource identifiers and text for the category, event message, and parameter insertion strings. Specifically, the message defined for resource identifier 1004 uses a placeholder for a parameter string defined for resource identifier 5002.
+
+```
+; // EventLogMsgs.mc
+; // ********************************************************
+
+; // Use the following commands to build this file:
+
+; //   mc -s EventLogMsgs.mc
+; //   rc EventLogMsgs.rc
+; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res
+; // ********************************************************
+
+; // - Event categories -
+; // Categories must be numbered consecutively starting at 1.
+; // ********************************************************
+
+MessageId=0x1
+Severity=Success
+SymbolicName=INSTALL_CATEGORY
+Language=English
+Installation
+.
+
+MessageId=0x2
+Severity=Success
+SymbolicName=QUERY_CATEGORY
+Language=English
+Database Query
+.
+
+MessageId=0x3
+Severity=Success
+SymbolicName=REFRESH_CATEGORY
+Language=English
+Data Refresh
+.
+
+; // - Event messages -
+; // *********************************
+
+MessageId = 1000
+Severity = Success
+Facility = Application
+SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
+Language=English
+My application message text, in English, for message id 1000, called from %1.
+.
+
+MessageId = 1001
+Severity = Warning
+Facility = Application
+SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
+Language=English
+My application message text, in English, for message id 1001, called from %1.
+.
+
+MessageId = 1002
+Severity = Success
+Facility = Application
+SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
+Language=English
+My generic information message in English, for message id 1002.
+.
+
+MessageId = 1003
+Severity = Warning
+Facility = Application
+SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
+Language=English
+My generic warning message in English, for message id 1003, called from %1.
+.
+
+MessageId = 1004
+Severity = Success
+Facility = Application
+SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
+Language=English
+The update cycle is complete for %%5002.
+.
+
+MessageId = 1005
+Severity = Warning
+Facility = Application
+SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
+Language=English
+The refresh operation did not complete because the connection to server %1 could not be established.
+.
+
+; // - Event log display name -
+; // ********************************************************
+
+MessageId = 5001
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
+Language=English
+Sample Event Log
+.
+
+; // - Event message parameters -
+; //   Language independent insertion strings
+; // ********************************************************
+
+MessageId = 5002
+Severity = Success
+Facility = Application
+SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
+Language=English
+SVC_UPDATE.EXE
+.
+```
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Diagnostics.EventSourceCreationData.ParameterResourceFile" />
@@ -1017,15 +1015,15 @@ SVC_UPDATE.EXE
         <param name="savedState">An <see cref="T:System.Collections.IDictionary" /> that contains the pre-installation state of the computer.</param>
         <summary>Restores the computer to the state it was in before the installation by rolling back the event log information that the installation procedure wrote to the registry.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method undoes the effects of the <xref:System.Diagnostics.EventLogInstaller.Install%2A> method. <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> is called if the installation of any component in the installation project fails. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method creates or sets the properties for an event log and event source. <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> either deletes the event log and source or resets the properties of a pre-existing source to its pre-installation values.  
-  
- Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). The tool calls the <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method, when this or another component has failed to install, to undo any changes that the installation process has already made.  
-  
- An application's install routine uses the project installer's <xref:System.Configuration.Install.Installer.Context%2A?displayProperty=nameWithType> property to automatically maintain information about the components that have already been installed. This state information, which is passed to <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> as the `savedState` parameter, is continuously updated as the tool rolls back each <xref:System.Diagnostics.EventLogInstaller>. Usually, it is not necessary for your code to explicitly modify this state information.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method undoes the effects of the <xref:System.Diagnostics.EventLogInstaller.Install%2A> method. <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> is called if the installation of any component in the installation project fails. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method creates or sets the properties for an event log and event source. <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> either deletes the event log and source or resets the properties of a pre-existing source to its pre-installation values.
+
+ Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool). The tool calls the <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> method, when this or another component has failed to install, to undo any changes that the installation process has already made.
+
+ An application's install routine uses the project installer's <xref:System.Configuration.Install.Installer.Context%2A?displayProperty=nameWithType> property to automatically maintain information about the components that have already been installed. This state information, which is passed to <xref:System.Diagnostics.EventLogInstaller.Rollback%2A> as the `savedState` parameter, is continuously updated as the tool rolls back each <xref:System.Diagnostics.EventLogInstaller>. Usually, it is not necessary for your code to explicitly modify this state information.
+
  ]]></format>
         </remarks>
         <altmember cref="M:System.Diagnostics.EventLogInstaller.Install(System.Collections.IDictionary)" />
@@ -1068,19 +1066,19 @@ SVC_UPDATE.EXE
         <summary>Gets or sets the source name to register with the log.</summary>
         <value>The name to register with the event log as a source of entries. The default is an empty string ("").</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The event source indicates what logs the event. It is often the name of the application, or the name of a component within a large application.  
-  
- The installer uses the value of the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property to register your application with the event log as a valid source of entries. A new source name cannot match an existing source name or an existing event log name. Each source can only write to one event log at a time; however, your application can use multiple sources to write to multiple event logs. For example, your application might require multiple sources configured for different event logs or different resource files.  
-  
- Applications and services should write to the Application log or a custom log. Device drivers should write to the System log. If you do not specify a log name before the installer runs, the installer registers your source to the Application log. If you specify the name of a log that does not exist, the system registers the <xref:System.Diagnostics.EventLogInstaller.Source%2A> to that log, but the log is not created until the first entry is written to it.  
-  
- Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method does not register the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.  
-  
- For more detailed information about the behaviors of event logs and sources, see the <xref:System.Diagnostics.EventLog> class documentation for the <xref:System.Diagnostics.EventLog.Log%2A> and <xref:System.Diagnostics.EventLog.Source%2A> properties.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The event source indicates what logs the event. It is often the name of the application, or the name of a component within a large application.
+
+ The installer uses the value of the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property to register your application with the event log as a valid source of entries. A new source name cannot match an existing source name or an existing event log name. Each source can only write to one event log at a time; however, your application can use multiple sources to write to multiple event logs. For example, your application might require multiple sources configured for different event logs or different resource files.
+
+ Applications and services should write to the Application log or a custom log. Device drivers should write to the System log. If you do not specify a log name before the installer runs, the installer registers your source to the Application log. If you specify the name of a log that does not exist, the system registers the <xref:System.Diagnostics.EventLogInstaller.Source%2A> to that log, but the log is not created until the first entry is written to it.
+
+ Use <xref:System.Diagnostics.EventLogInstaller> to register a new source for a new or existing event log; do not use <xref:System.Diagnostics.EventLogInstaller> to change an existing source. The <xref:System.Diagnostics.EventLogInstaller> class does not modify the configuration properties of an existing source to match the specified installation properties. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method throws an exception if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is registered for a different event log on the computer. The <xref:System.Diagnostics.EventLogInstaller.Install%2A> method does not register the source if the <xref:System.Diagnostics.EventLogInstaller.Source%2A> property matches a source name that is already registered for the same event log specified in the <xref:System.Diagnostics.EventLogInstaller.Log%2A> property.
+
+ For more detailed information about the behaviors of event logs and sources, see the <xref:System.Diagnostics.EventLog> class documentation for the <xref:System.Diagnostics.EventLog.Log%2A> and <xref:System.Diagnostics.EventLog.Source%2A> properties.
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Diagnostics.EventLog.Source" />
@@ -1111,15 +1109,15 @@ SVC_UPDATE.EXE
         <param name="savedState">An <see cref="T:System.Collections.IDictionary" /> that contains the pre-installation state of the computer.</param>
         <summary>Removes an installation by removing event log information from the registry.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If the <xref:System.Diagnostics.EventLogInstaller.UninstallAction%2A> property value is `Remove`, the <xref:System.Diagnostics.EventLogInstaller.Uninstall%2A> method deletes the source and the associated log that the installer created if the <xref:System.Diagnostics.EventLogInstaller.Log%2A> and <xref:System.Diagnostics.EventLogInstaller.Source%2A> properties specified the creation of a new event log and source.  
-  
- Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) in uninstall mode. The tool automatically calls the <xref:System.Diagnostics.EventLogInstaller.Uninstall%2A> method to restore the parts of the system that were affected by the installation to their pre-installation states. This includes deleting registry information that is associated with the event log being uninstalled.  
-  
- An application's uninstall routine uses the project installer's <xref:System.Configuration.Install.Installer.Context%2A?displayProperty=nameWithType> property to automatically maintain information about the components that have already been uninstalled. This state information, which is passed to <xref:System.Diagnostics.EventLogInstaller.Uninstall%2A> as the `savedState` parameter, is continuously updated as the tool uninstalls each <xref:System.Diagnostics.EventLogInstaller>. Usually, it is not necessary for your code to explicitly modify this state information.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ If the <xref:System.Diagnostics.EventLogInstaller.UninstallAction%2A> property value is `Remove`, the <xref:System.Diagnostics.EventLogInstaller.Uninstall%2A> method deletes the source and the associated log that the installer created if the <xref:System.Diagnostics.EventLogInstaller.Log%2A> and <xref:System.Diagnostics.EventLogInstaller.Source%2A> properties specified the creation of a new event log and source.
+
+ Typically, you do not call the methods of the <xref:System.Diagnostics.EventLogInstaller> from within your code; they are generally called only by the [Installutil.exe (Installer Tool)](/dotnet/framework/tools/installutil-exe-installer-tool) in uninstall mode. The tool automatically calls the <xref:System.Diagnostics.EventLogInstaller.Uninstall%2A> method to restore the parts of the system that were affected by the installation to their pre-installation states. This includes deleting registry information that is associated with the event log being uninstalled.
+
+ An application's uninstall routine uses the project installer's <xref:System.Configuration.Install.Installer.Context%2A?displayProperty=nameWithType> property to automatically maintain information about the components that have already been uninstalled. This state information, which is passed to <xref:System.Diagnostics.EventLogInstaller.Uninstall%2A> as the `savedState` parameter, is continuously updated as the tool uninstalls each <xref:System.Diagnostics.EventLogInstaller>. Usually, it is not necessary for your code to explicitly modify this state information.
+
  ]]></format>
         </remarks>
         <altmember cref="M:System.Diagnostics.EventLogInstaller.Install(System.Collections.IDictionary)" />
@@ -1153,11 +1151,11 @@ SVC_UPDATE.EXE
         <summary>Gets or sets a value that indicates whether the <see href="https://learn.microsoft.com/dotnet/framework/tools/installutil-exe-installer-tool">Installutil.exe (Installer Tool)</see> should remove the event log or leave it in its installed state at uninstall time.</summary>
         <value>One of the <see cref="T:System.Configuration.Install.UninstallAction" /> values that indicates what state to leave the event log in when the <see cref="T:System.Diagnostics.EventLog" /> is uninstalled. The default is <see langword="Remove" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- When you install an event log, you can optionally connect it to an existing log. If you do so, you must decide whether the log should return to its pre-installation state, or remain in its current, post-installation state. If you elect to return the event log to its pre-installation state, changes to the event log entries at installation are not restored. You can reset only the event log properties that are associated with the <xref:System.Diagnostics.EventLogInstaller> to their pre-installation values.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ When you install an event log, you can optionally connect it to an existing log. If you do so, you must decide whether the log should return to its pre-installation state, or remain in its current, post-installation state. If you elect to return the event log to its pre-installation state, changes to the event log entries at installation are not restored. You can reset only the event log properties that are associated with the <xref:System.Diagnostics.EventLogInstaller> to their pre-installation values.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ComponentModel.InvalidEnumArgumentException">
diff --git a/xml/System.Globalization/NumberFormatInfo.xml b/xml/System.Globalization/NumberFormatInfo.xml
index f2bbfbe1a37..7a8598e2009 100644
--- a/xml/System.Globalization/NumberFormatInfo.xml
+++ b/xml/System.Globalization/NumberFormatInfo.xml
@@ -82,14 +82,21 @@
   </Attributes>
   <Docs>
     <summary>Provides culture-specific information for formatting and parsing numeric values.</summary>
-    <remarks>For more information about this API, see <see href="/dotnet/fundamentals/runtime-libraries/system-globalization-numberformatinfo">Supplemental API remarks for NumberFormatInfo</see>.</remarks>
-    <example>
-      The following example shows how to retrieve a <see cref="T:System.Globalization.NumberFormatInfo" /> object for a corresponding <see cref="T:System.Globalization.CultureInfo" /> object, and use the retrieved object to query number formatting information for the particular culture.
+    <remarks>
       <format type="text/markdown"><![CDATA[
-        :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/NumberFormatInfo/cpp/NumberFormatInfo.cpp" id="Snippet1":::
-        :::code language="csharp" source="~/snippets/csharp/System.Globalization/NumberFormatInfo/Overview/NumberFormatInfo.cs" id="Snippet1":::
-        :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/NumberFormatInfo/vb/numberformatinfo.vb" id="Snippet1":::
-      ]]></format></example>
+
+      For more information about this API, see [Supplemental API remarks for NumberFormatInfo](/dotnet/fundamentals/runtime-libraries/system-globalization-numberformatinfo).
+
+      ## Example
+
+      The following example shows how to retrieve a <xref:System.Globalization.NumberFormatInfo> object for a corresponding <xref:System.Globalization.CultureInfo> object, and use the retrieved object to query number formatting information for the particular culture.
+
+      :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/NumberFormatInfo/cpp/NumberFormatInfo.cpp" id="Snippet1":::
+      :::code language="csharp" source="~/snippets/csharp/System.Globalization/NumberFormatInfo/Overview/NumberFormatInfo.cs" id="Snippet1":::
+      :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/NumberFormatInfo/vb/numberformatinfo.vb" id="Snippet1":::
+
+      ]]></format>
+    </remarks>
     <altmember cref="T:System.Globalization.CultureInfo" />
     <altmember cref="T:System.IFormatProvider" />
     <related type="Article" href="/dotnet/standard/base-types/custom-numeric-format-strings">Custom Numeric Format Strings</related>
@@ -272,8 +279,6 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits%2A> property is used with the "C" standard format string without a precision specifier in numeric formatting operations. It defines the default number of fractional digits that appear after the decimal separator. This value is overridden if a precision specifier is used. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits%2A> property.
 
@@ -341,12 +346,10 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The initial value of this property is derived from the settings in the **Region and Language** item in Control Panel.
+On Windows, the initial value of this property is derived from the settings in the **Region and Language** item in Control Panel.
 
  The <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator%2A> property is used with the "C" standard format string to define the symbol that separates integral from fractional digits. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator%2A> property.
 
@@ -415,12 +418,10 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The initial value of this property is derived from the settings in the **Regional and Language** item in Control Panel.
+On Windows, the initial value of this property is derived from the settings in the **Regional and Language** item in Control Panel.
 
  The <xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator%2A> property is used with the "C" standard format string to define the symbol that separates groups of integral digits. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator%2A> property.
 
@@ -492,9 +493,7 @@
 
  The first element of the array defines the number of elements in the least significant group of digits immediately to the left of the <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator%2A>. Each subsequent element refers to the next significant group of digits to the left of the previous group. If the last element of the array is not 0, the remaining digits are grouped based on the last element of the array. If the last element is 0, the remaining digits are not grouped.
 
- For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "$55,55555,55555,55555,4444,333.00". If the array contains { 3, 4, 0 }, the digits are grouped similar to "$55555555555555555,4444,333.00".
-
-
+ For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "\\$55,55555,55555,55555,4444,333.00". If the array contains { 3, 4, 0 }, the digits are grouped similar to "\\$55555555555555555,4444,333.00".
 
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.CurrencyGroupSizes%2A> property.
@@ -563,34 +562,32 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the format pattern for negative currency values.</summary>
-        <value>The format pattern for negative currency values. The default for <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> is 0, which represents "($n)", where "$" is the <see cref="P:System.Globalization.NumberFormatInfo.CurrencySymbol" /> and <paramref name="n" /> is a number.</value>
+        <value>The format pattern for negative currency values. The default for <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> is 0, which represents "(\\$n)", where "\\$" is the <see cref="P:System.Globalization.NumberFormatInfo.CurrencySymbol" /> and <paramref name="n" /> is a number.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern%2A> property is used with the "C" standard format string to define the pattern of negative currency values. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings). This property has one of the values in the following table. The symbol "$" is the <xref:System.Globalization.NumberFormatInfo.CurrencySymbol%2A>, the symbol "-" is the <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>, and `n` is a number.
 
-|Value|Associated pattern|
-|-----------|------------------------|
-|0|($n)|
-|1|-$n|
-|2|$-n|
-|3|$n-|
-|4|(n$)|
-|5|-n$|
-|6|n-$|
-|7|n$-|
-|8|-n $|
-|9|-$ n|
-|10|n $-|
-|11|$ n-|
-|12|$ -n|
-|13|n- $|
-|14|($ n)|
-|15|(n $)|
-|16|$- n|
-
-
+| Value | Associated pattern |
+|-------|--------------------|
+| 0     | ($n)               |
+| 1     | -$n                |
+| 2     | $-n                |
+| 3     | $n-                |
+| 4     | (n$)               |
+| 5     | -n$                |
+| 6     | n-$                |
+| 7     | n$-                |
+| 8     | -n $               |
+| 9     | -$ n               |
+| 10    | n $-               |
+| 11    | $ n-               |
+| 12    | $ -n               |
+| 13    | n- $               |
+| 14    | ($ n)              |
+| 15    | (n $)              |
+| 16    | $- n               |
 
 ## Examples
  The following example shows how the <xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern%2A> property defines the format of negative currency values.  It retrieves all the specific cultures that are defined on the host computer and displays each culture's <xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern%2A> property value, its associated pattern, and a number formatted as a currency value.
@@ -653,21 +650,21 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the format pattern for positive currency values.</summary>
-        <value>The format pattern for positive currency values. The default for <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> is 0, which represents "$n", where "$" is the <see cref="P:System.Globalization.NumberFormatInfo.CurrencySymbol" /> and <paramref name="n" /> is a number.</value>
+        <value>The format pattern for positive currency values. The default for <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> is 0, which represents "\\$n", where "\\$" is the <see cref="P:System.Globalization.NumberFormatInfo.CurrencySymbol" /> and <paramref name="n" /> is a number.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.CurrencyPositivePattern%2A> property is used with the "C" standard format string to define pattern of positive currency values. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings). This property has one of the values in the following table. The symbol "$" is the <xref:System.Globalization.NumberFormatInfo.CurrencySymbol%2A> and `n` is a number.
 
-|Value|Associated pattern|
-|-----------|------------------------|
-|0|$n|
-|1|n$|
-|2|$ n|
-|3|n $|
+| Value | Associated pattern |
+|-------|--------------------|
+| 0     | $n                 |
+| 1     | n$                 |
+| 2     | $ n                |
+| 3     | n $                |
 
- Note that the pattern does not support a positive sign.
+The pattern does not support a positive sign.
 
  ]]></format>
         </remarks>
@@ -730,8 +727,6 @@
 ## Remarks
  The string assigned to the <xref:System.Globalization.NumberFormatInfo.CurrencySymbol%2A> property is included in the result string when a numeric value is formatted with the "C" [standard numeric format string](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example displays the currency symbol for the current culture and uses the "C" standard numeric format string to format a currency value.
 
@@ -807,8 +802,6 @@
 ## Remarks
  Retrieving a <xref:System.Globalization.NumberFormatInfo> object from the <xref:System.Globalization.NumberFormatInfo.CurrentInfo%2A> property is equivalent to retrieving a <xref:System.Globalization.NumberFormatInfo> object from the `CultureInfo.CurrentCulture.NumberFormat` property.
 
-
-
 ## Examples
  The following example shows that the objects returned by the <xref:System.Globalization.NumberFormatInfo.CurrentInfo%2A> and   `CultureInfo.CurrentCulture.NumberFormat` properties are identical. It then uses reflection to display the property values of the <xref:System.Globalization.NumberFormatInfo> object returned by the <xref:System.Globalization.NumberFormatInfo.CurrentInfo%2A> property on a system whose current culture is en-US.
 
@@ -869,10 +862,8 @@
         <remarks>
           <format type="text/markdown"><![CDATA[
 
-## Remarks
-
 > [!IMPORTANT]
->  The <xref:System.Globalization.NumberFormatInfo.DigitSubstitution%2A> property is reserved for future use. Currently, it is not used in either parsing or formatting operations for the current <xref:System.Globalization.NumberFormatInfo> object.
+> The <xref:System.Globalization.NumberFormatInfo.DigitSubstitution%2A> property is reserved for future use. Currently, it is not used in either parsing or formatting operations for the current <xref:System.Globalization.NumberFormatInfo> object.
 
  ]]></format>
         </remarks>
@@ -1014,9 +1005,8 @@
 
  Your application gets a <xref:System.Globalization.NumberFormatInfo> object for a specific culture using one of the following methods:
 
--   Through the <xref:System.Globalization.CultureInfo.NumberFormat%2A?displayProperty=nameWithType> property.
-
--   Through the <xref:System.Globalization.NumberFormatInfo.GetInstance%2A> method where `provider` is a <xref:System.Globalization.CultureInfo>.
+- Through the <xref:System.Globalization.CultureInfo.NumberFormat%2A?displayProperty=nameWithType> property.
+- Through the <xref:System.Globalization.NumberFormatInfo.GetInstance%2A> method where `provider` is a <xref:System.Globalization.CultureInfo>.
 
  A <xref:System.Globalization.NumberFormatInfo> object is created only for the invariant culture or for specific cultures, not for neutral cultures. For more information about the invariant culture, specific cultures, and neutral cultures, see the <xref:System.Globalization.CultureInfo> class.
 
@@ -1073,8 +1063,6 @@
 ## Remarks
  This <xref:System.Globalization.NumberFormatInfo> object returned by this property does not change, regardless of the current culture. It represents the formatting conventions of the invariant culture, which is a culture associated with the English language but not with any country/region. The invariant culture is used in formatting operations that are culture-independent or that produce result strings suitable for display across multiple cultures.
 
-
-
 ## Examples
  The following example displays the default property values of the <xref:System.Globalization.NumberFormatInfo.InvariantInfo%2A>.
 
@@ -1252,9 +1240,7 @@
 ## Remarks
 
 > [!IMPORTANT]
->  The character set that is specified by the <xref:System.Globalization.NumberFormatInfo.NativeDigits%2A> property has no effect on parsing or formatting operations. Only the Basic Latin digits 0 (U+0030) through 9 (U+0039) are used when formatting or parsing numeric values or date and time values.
-
-
+> The character set that's specified by the <xref:System.Globalization.NumberFormatInfo.NativeDigits%2A> property has no effect on parsing or formatting operations. Only the Basic Latin digits 0 (U+0030) through 9 (U+0039) are used when formatting or parsing numeric values or date and time values.
 
 ## Examples
  The following example demonstrates the <xref:System.Globalization.NumberFormatInfo.NativeDigits%2A> property.
@@ -1332,7 +1318,6 @@
         <remarks>
           <format type="text/markdown"><![CDATA[
 
-## Remarks
  For more information on negative infinity, see <xref:System.Double> or <xref:System.Single>.
 
  ]]></format>
@@ -1391,8 +1376,6 @@
 ## Remarks
  This property is used in both formatting and parsing operations. For more information on its use in formatting operations, see the [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings) and [Custom Numeric Format Strings](/dotnet/standard/base-types/custom-numeric-format-strings) topics.
 
-
-
 ## Examples
  The following example instantiates a read-write <xref:System.Globalization.CultureInfo> object that represents the invariant culture and assigns the OVERLINE character (U+203E) to its <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A> property. It then uses this <xref:System.Globalization.CultureInfo> object to format an array of negative floating-point numbers.
 
@@ -1454,8 +1437,6 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A> property is used with the "F" and "N" standard format strings without a precision specifier in numeric formatting operations. It defines the default number of fractional digits that appear after the decimal separator. This value is overridden if a precision specifier is used. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A> property.
 
@@ -1524,9 +1505,7 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> property is used with the "E", "F", "G", "N", and "R" standard format strings to define the symbol that separates integral from fractional digits. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
- The initial value of this property is derived from the settings in the **Region and Language** item in Control Panel.
-
-
+On Windows, the initial value of this property is derived from the settings in the **Region and Language** item in Control Panel.
 
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> property.
@@ -1597,9 +1576,7 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.NumberGroupSeparator%2A> property is used with the "N" standard format string to define the symbol that separates groups of integral digits. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
- The initial value of this property is derived from the settings in the **Region and Language** item in Control Panel.
-
-
+On Windows, the initial value of this property is derived from the settings in the **Region and Language** item in Control Panel.
 
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.NumberGroupSeparator%2A> property.
@@ -1675,8 +1652,6 @@
 
  For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "55,55555,55555,55555,4444,333.00". If the array contains { 3, 4, 0 }, the digits are grouped similar to "55555555555555555,4444,333.00".
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.NumberGroupSizes%2A> property.
 
@@ -1756,18 +1731,16 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.NumberNegativePattern%2A> property defines the format of negative values formatted with the "N" standard numeric format string. This property has one of the values in the following table. The symbol "-" is the <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A> and `n` is a number.
 
-|Value|Associated pattern|
-|-----------|------------------------|
-|0|(n)|
-|1|-n|
-|2|- n|
-|3|n-|
-|4|n -|
+| Value | Associated pattern |
+|-------|--------------------|
+| 0     | (n)                |
+| 1     | -n                 |
+| 2     | - n                |
+| 3     | n-                 |
+| 4     | n -                |
 
  The default value for the invariant culture returned by the <xref:System.Globalization.NumberFormatInfo.InvariantInfo%2A> property is 1, which represents "-n", where *n* is a number.
 
-
-
 ## Examples
  The following example displays a value using different <xref:System.Globalization.NumberFormatInfo.NumberNegativePattern%2A> patterns.
 
@@ -1836,8 +1809,6 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.PercentDecimalDigits%2A> property is used with the "P" standard format string without a precision specifier in numeric formatting operations. It defines the default number of fractional digits that appear after the decimal separator. This value is overridden if a precision specifier is used. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.PercentDecimalDigits%2A> property.
 
@@ -1907,8 +1878,6 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.PercentDecimalSeparator%2A> property is used with the "P" standard format string to define the symbol that separates integral from fractional digits. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.PercentDecimalSeparator%2A> property.
 
@@ -1979,8 +1948,6 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.PercentGroupSeparator%2A> property is used with the "P" standard format string to define the symbol that separates groups of integers. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings).
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.PercentGroupSeparator%2A> property.
 
@@ -2054,8 +2021,6 @@
 
  For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "55,55555,55555,55555,4444,333.00%". If the array contains { 3, 4, 0 }, the digits are grouped similar to "55555555555555555,4444,333.00%".
 
-
-
 ## Examples
  The following example demonstrates the effect of changing the <xref:System.Globalization.NumberFormatInfo.PercentGroupSizes%2A> property.
 
@@ -2130,20 +2095,20 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.PercentNegativePattern%2A> property is used with the "P" standard format string to define the pattern of negative percentage values. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings). This property has one of the values in the following table. The symbol "%" is the <xref:System.Globalization.NumberFormatInfo.PercentSymbol%2A>, the symbol "-" is the <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>, and `n` is a number. Values 3-11 were introduced in the .NET Framework 2.0 and cannot be used in earlier versions.
 
-|Value|Associated pattern|
-|-----------|------------------------|
-|0|-n %|
-|1|-n%|
-|2|-%n|
-|3|%-n|
-|4|%n-|
-|5|n-%|
-|6|n%-|
-|7|-% n|
-|8|n %-|
-|9|% n-|
-|10|% -n|
-|11|n- %|
+| Value | Associated pattern |
+|-------|--------------------|
+| 0     | -n %               |
+| 1     | -n%                |
+| 2     | -%n                |
+| 3     | %-n                |
+| 4     | %n-                |
+| 5     | n-%                |
+| 6     | n%-                |
+| 7     | -% n               |
+| 8     | n %-               |
+| 9     | % n-               |
+| 10    | % -n               |
+| 11    | n- %               |
 
  ]]></format>
         </remarks>
@@ -2207,12 +2172,12 @@
 ## Remarks
  The <xref:System.Globalization.NumberFormatInfo.PercentPositivePattern%2A> property is used with the "P" standard format string to define pattern of positive percentage values. For more information, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings). This property has one of the values in the following table. The symbol "%" is the <xref:System.Globalization.NumberFormatInfo.PercentSymbol%2A> and `n` is a number.
 
-|Value|Associated pattern|
-|-----------|------------------------|
-|0|n %|
-|1|n%|
-|2|%n|
-|3|% n|
+| Value | Associated pattern |
+|-------|--------------------|
+| 0     | n %                |
+| 1     | n%                 |
+| 2     | %n                 |
+| 3     | % n                |
 
  ]]></format>
         </remarks>
diff --git a/xml/System.Net/Cookie.xml b/xml/System.Net/Cookie.xml
index 7f0d7c562e0..07788ff778b 100644
--- a/xml/System.Net/Cookie.xml
+++ b/xml/System.Net/Cookie.xml
@@ -62,22 +62,22 @@
   <Docs>
     <summary>Provides a set of properties and methods that are used to manage cookies. This class cannot be inherited.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Cookie> class is used by a client application to retrieve information about cookies that are received with HTTP responses. The following cookie formats are supported during parsing of the HTTP response headers: the original Netscape specification, RFC 2109, and RFC 2965.  
-  
- For a list of initial property values for an instance of <xref:System.Net.Cookie>, see the various <xref:System.Net.Cookie> constructors.  
-  
-   
-  
-## Examples  
- The following example sends a request to a URL and displays the cookies returned in the response.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Cookie> class is used by a client application to retrieve information about cookies that are received with HTTP responses. The following cookie formats are supported during parsing of the HTTP response headers: the original Netscape specification, RFC 2109, and RFC 2965.
+
+ For a list of initial property values for an instance of <xref:System.Net.Cookie>, see the various <xref:System.Net.Cookie> constructors.
+
+
+
+## Examples
+ The following example sends a request to a URL and displays the cookies returned in the response.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet1":::
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.Net.CookieCollection" />
@@ -137,11 +137,11 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Cookie" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The parameterless constructor initializes all fields to their default values, using empty strings ("") for `name`, `value`, `path`, and `domain`. Note that at least the <xref:System.Net.Cookie.Name%2A> property must be initialized before using an instance of the <xref:System.Net.Cookie> class.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The parameterless constructor initializes all fields to their default values, using empty strings ("") for `name`, `value`, `path`, and `domain`. Note that at least the <xref:System.Net.Cookie.Name%2A> property must be initialized before using an instance of the <xref:System.Net.Cookie> class.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -200,47 +200,47 @@
         <param name="value">The value of a <see cref="T:System.Net.Cookie" />. The following characters must not be used inside <paramref name="value" />: semicolon, comma.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Cookie" /> class with a specified <see cref="P:System.Net.Cookie.Name" /> and <see cref="P:System.Net.Cookie.Value" />.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The default for the `value` parameter uses the empty string ("").  
-  
- The `value` parameter for a <xref:System.Net.Cookie> must not be a `null` reference (Nothing in Visual Basic). The semicolon (";") and comma (",") characters are reserved and cannot be passed in the `value` parameter unless the string passed in the `value` parameter is enclosed in double quotes. So the following example constructor would succeed, but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add(System.Net.Cookie)> or <xref:System.Net.CookieContainer.Add(System.Uri,System.Net.Cookie)> methods, the operation will fail and throw an exception:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The default for the `value` parameter uses the empty string ("").
+
+ The `value` parameter for a <xref:System.Net.Cookie> must not be a `null` reference (Nothing in Visual Basic). The semicolon (";") and comma (",") characters are reserved and cannot be passed in the `value` parameter unless the string passed in the `value` parameter is enclosed in double quotes. So the following example constructor would succeed, but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add(System.Net.Cookie)> or <xref:System.Net.CookieContainer.Add(System.Uri,System.Net.Cookie)> methods, the operation will fail and throw an exception:
+
  ```csharp
  System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
  cookie.Domain = "contoso.com";
  new CookieContainer().Add(cookie);
- ```  
-  
- However, the following constructor with these special characters escaped will create a <xref:System.Net.Cookie> that can be added to a <xref:System.Net.CookieContainer> instance:  
- 
+ ```
+
+ However, the following constructor with these special characters escaped will create a <xref:System.Net.Cookie> that can be added to a <xref:System.Net.CookieContainer> instance:
+
  ```csharp
  System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
  cookie.Domain = "contoso.com";
  new CookieContainer().Add(cookie);
  ```
-  
- The comma character is used as a delimiter between separate cookies on the same line.  
-  
+
+ The comma character is used as a delimiter between separate cookies on the same line.
+
  ]]></format>
         </remarks>
-        <exception cref="T:System.Net.CookieException">The <paramref name="name" /> parameter is <see langword="null" />.  
-  
- -or-  
-  
- The <paramref name="name" /> parameter is of zero length.  
-  
- -or-  
-  
- The <paramref name="name" /> parameter contains an invalid character.  
-  
- -or-  
-  
- The <paramref name="value" /> parameter is <see langword="null" /> .  
-  
- -or -  
-  
+        <exception cref="T:System.Net.CookieException">The <paramref name="name" /> parameter is <see langword="null" />.
+
+ -or-
+
+ The <paramref name="name" /> parameter is of zero length.
+
+ -or-
+
+ The <paramref name="name" /> parameter contains an invalid character.
+
+ -or-
+
+ The <paramref name="value" /> parameter is <see langword="null" /> .
+
+ -or -
+
  The <paramref name="value" /> parameter contains a string not enclosed in quotes that contains an invalid character.</exception>
         <altmember cref="T:System.Net.CookieCollection" />
         <altmember cref="T:System.Net.CookieContainer" />
@@ -303,47 +303,47 @@
         <param name="path">The subset of URIs on the origin server to which this <see cref="T:System.Net.Cookie" /> applies. The default value is "/".</param>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Cookie" /> class with a specified <see cref="P:System.Net.Cookie.Name" />, <see cref="P:System.Net.Cookie.Value" />, and <see cref="P:System.Net.Cookie.Path" />.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The default for the `path` parameter uses the empty string ("").  
-  
- The `value` parameter for a <xref:System.Net.Cookie> must not be a `null` reference (Nothing in Visual Basic). The semicolon (";") and comma (",") characters are reserved and cannot be passed in the `value` parameter unless the string passed in the `value` parameter is enclosed in double quotes. So the following example constructor would succeed, but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add(System.Net.Cookie)> or <xref:System.Net.CookieContainer.Add(System.Uri,System.Net.Cookie)> methods, the operation will fail and throw an exception:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The default for the `path` parameter uses the empty string ("").
+
+ The `value` parameter for a <xref:System.Net.Cookie> must not be a `null` reference (Nothing in Visual Basic). The semicolon (";") and comma (",") characters are reserved and cannot be passed in the `value` parameter unless the string passed in the `value` parameter is enclosed in double quotes. So the following example constructor would succeed, but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add(System.Net.Cookie)> or <xref:System.Net.CookieContainer.Add(System.Uri,System.Net.Cookie)> methods, the operation will fail and throw an exception:
+
  ```csharp
  System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
  cookie.Domain = "contoso.com";
  new CookieContainer().Add(cookie);
- ```  
-  
- However, the following constructor with these special characters escaped will create a <xref:System.Net.Cookie> that can be added to a <xref:System.Net.CookieContainer> instance:  
- 
+ ```
+
+ However, the following constructor with these special characters escaped will create a <xref:System.Net.Cookie> that can be added to a <xref:System.Net.CookieContainer> instance:
+
  ```csharp
  System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
  cookie.Domain = "contoso.com";
  new CookieContainer().Add(cookie);
- ``` 
-  
- The comma character is used as a delimiter between separate cookies on the same line.  
-  
+ ```
+
+ The comma character is used as a delimiter between separate cookies on the same line.
+
  ]]></format>
         </remarks>
-        <exception cref="T:System.Net.CookieException">The <paramref name="name" /> parameter is <see langword="null" />.  
-  
- -or-  
-  
- The <paramref name="name" /> parameter is of zero length.  
-  
- -or-  
-  
- The <paramref name="name" /> parameter contains an invalid character.  
-  
- -or-  
-  
- The <paramref name="value" /> parameter is <see langword="null" /> .  
-  
- -or -  
-  
+        <exception cref="T:System.Net.CookieException">The <paramref name="name" /> parameter is <see langword="null" />.
+
+ -or-
+
+ The <paramref name="name" /> parameter is of zero length.
+
+ -or-
+
+ The <paramref name="name" /> parameter contains an invalid character.
+
+ -or-
+
+ The <paramref name="value" /> parameter is <see langword="null" /> .
+
+ -or -
+
  The <paramref name="value" /> parameter contains a string not enclosed in quotes that contains an invalid character.</exception>
         <altmember cref="T:System.Net.CookieCollection" />
         <altmember cref="T:System.Net.CookieContainer" />
@@ -408,45 +408,45 @@
         <param name="domain">The optional internet domain for which this <see cref="T:System.Net.Cookie" /> is valid. The default value is the host this <see cref="T:System.Net.Cookie" /> has been received from.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Cookie" /> class with a specified <see cref="P:System.Net.Cookie.Name" />, <see cref="P:System.Net.Cookie.Value" />, <see cref="P:System.Net.Cookie.Path" />, and <see cref="P:System.Net.Cookie.Domain" />.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The default for the `domain` and `path` parameters uses the empty string ("").  
-  
- The `value` parameter for a <xref:System.Net.Cookie> must not be a `null` reference (Nothing in Visual Basic). The semicolon (";") and comma (",") characters are reserved and cannot be passed in the `value` parameter unless the string passed in the `value` parameter is enclosed in double quotes. So the following example constructor would succeed, but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add(System.Net.Cookie)> or <xref:System.Net.CookieContainer.Add(System.Uri,System.Net.Cookie)> methods, the operation will fail and throw an exception:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The default for the `domain` and `path` parameters uses the empty string ("").
+
+ The `value` parameter for a <xref:System.Net.Cookie> must not be a `null` reference (Nothing in Visual Basic). The semicolon (";") and comma (",") characters are reserved and cannot be passed in the `value` parameter unless the string passed in the `value` parameter is enclosed in double quotes. So the following example constructor would succeed, but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add(System.Net.Cookie)> or <xref:System.Net.CookieContainer.Add(System.Uri,System.Net.Cookie)> methods, the operation will fail and throw an exception:
+
  ```csharp
  System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
  new CookieContainer().Add(cookie);
- ```  
-  
- However, the following constructor with these special characters escaped will create a <xref:System.Net.Cookie> that can be added to a <xref:System.Net.CookieContainer> instance:  
- 
+ ```
+
+ However, the following constructor with these special characters escaped will create a <xref:System.Net.Cookie> that can be added to a <xref:System.Net.CookieContainer> instance:
+
  ```csharp
  System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
  new CookieContainer().Add(cookie);
- ```  
-  
- The comma character is used as a delimiter between separate cookies on the same line.  
-  
+ ```
+
+ The comma character is used as a delimiter between separate cookies on the same line.
+
  ]]></format>
         </remarks>
-        <exception cref="T:System.Net.CookieException">The <paramref name="name" /> parameter is <see langword="null" />.  
-  
- -or-  
-  
- The <paramref name="name" /> parameter is of zero length.  
-  
- -or-  
-  
- The <paramref name="name" /> parameter contains an invalid character.  
-  
- -or-  
-  
- The <paramref name="value" /> parameter is <see langword="null" /> .  
-  
- -or -  
-  
+        <exception cref="T:System.Net.CookieException">The <paramref name="name" /> parameter is <see langword="null" />.
+
+ -or-
+
+ The <paramref name="name" /> parameter is of zero length.
+
+ -or-
+
+ The <paramref name="name" /> parameter contains an invalid character.
+
+ -or-
+
+ The <paramref name="value" /> parameter is <see langword="null" /> .
+
+ -or -
+
  The <paramref name="value" /> parameter contains a string not enclosed in quotes that contains an invalid character.</exception>
         <altmember cref="T:System.Net.CookieCollection" />
         <altmember cref="T:System.Net.CookieContainer" />
@@ -503,20 +503,20 @@
         <summary>Gets or sets a comment that the server can add to a <see cref="T:System.Net.Cookie" />.</summary>
         <value>An optional comment to document intended usage for this <see cref="T:System.Net.Cookie" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The client can inspect this optional comment for information added by the server. For example, the server could include information about issues like the privacy policy or intended usage.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The client can inspect this optional comment for information added by the server. For example, the server could include information about issues like the privacy policy or intended usage.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -583,20 +583,20 @@
         <summary>Gets or sets a URI comment that the server can provide with a <see cref="T:System.Net.Cookie" />.</summary>
         <value>An optional comment that represents the intended usage of the URI reference for this <see cref="T:System.Net.Cookie" />. The value must conform to URI format.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The URI can provide optional information, such as how the server uses the <xref:System.Net.Cookie>.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies that are returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The URI can provide optional information, such as how the server uses the <xref:System.Net.Cookie>.
+
+
+
+## Examples
+ The following example displays the properties of cookies that are returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -659,20 +659,20 @@
         <value>
           <see langword="true" /> if the client is to discard the <see cref="T:System.Net.Cookie" /> at the end of the current session; otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- When `true`, this property instructs the client application not to save the <xref:System.Net.Cookie> on the user's hard disk when a session ends.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ When `true`, this property instructs the client application not to save the <xref:System.Net.Cookie> on the user's hard disk when a session ends.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -730,20 +730,20 @@
         <summary>Gets or sets the URI for which the <see cref="T:System.Net.Cookie" /> is valid.</summary>
         <value>The URI for which the <see cref="T:System.Net.Cookie" /> is valid.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- A server cannot indicate a domain other than its own URI. However, it can indicate more than one server in the domain. The default value is the host that this cookie has been received from.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ A server cannot indicate a domain other than its own URI. However, it can indicate more than one server in the domain. The default value is the host that this cookie has been received from.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -857,20 +857,20 @@
         <value>
           <see langword="true" /> if the <see cref="T:System.Net.Cookie" /> has expired; otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Expired cookies, if received, should be destroyed by the client application.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Expired cookies, if received, should be destroyed by the client application.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -932,22 +932,22 @@
         <summary>Gets or sets the expiration date and time for the <see cref="T:System.Net.Cookie" /> as a <see cref="T:System.DateTime" />.</summary>
         <value>The expiration date and time for the <see cref="T:System.Net.Cookie" /> as a <see cref="T:System.DateTime" /> instance.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Setting the `Expires` property to <xref:System.DateTime.MinValue?displayProperty=nameWithType> makes this a session cookie, which is its default value.  
-  
- The <xref:System.DateTime.Kind> property of <xref:System.Net.Cookie.Expires%2A> is used to determine if the cookie is set to <xref:System.DateTimeKind.Local?displayProperty=nameWithType> or <xref:System.DateTimeKind.Utc?displayProperty=nameWithType>. If the <xref:System.DateTime.Kind> property is set to <xref:System.DateTimeKind.Unspecified?displayProperty=nameWithType>, then <xref:System.DateTimeKind.Utc> is assumed.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Setting the `Expires` property to <xref:System.DateTime.MinValue?displayProperty=nameWithType> makes this a session cookie, which is its default value.
+
+ The <xref:System.DateTime.Kind> property of <xref:System.Net.Cookie.Expires%2A> is used to determine if the cookie is set to <xref:System.DateTimeKind.Local?displayProperty=nameWithType> or <xref:System.DateTimeKind.Utc?displayProperty=nameWithType>. If the <xref:System.DateTime.Kind> property is set to <xref:System.DateTimeKind.Unspecified?displayProperty=nameWithType>, then <xref:System.DateTimeKind.Utc> is assumed.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -1000,11 +1000,11 @@
         <summary>Overrides the <see cref="M:System.Object.GetHashCode" /> method.</summary>
         <returns>The 32-bit signed integer hash code for this instance.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Classes that might be used as a key in a hash table must provide this override, because objects that are used as keys in a hash table are required to generate their own hash code through this method.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Classes that might be used as a key in a hash table must provide this override, because objects that are used as keys in a hash table are required to generate their own hash code through this method.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -1062,11 +1062,11 @@
         <summary>Determines whether a page script or other active content can access this cookie.</summary>
         <value>Boolean value that determines whether a page script or other active content can access this cookie.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- When this property is set to `true`, a page script or other active content cannot access this cookie.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ When this property is set to `true`, a page script or other active content cannot access this cookie.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -1121,28 +1121,26 @@
         <summary>Gets or sets the name for the <see cref="T:System.Net.Cookie" />.</summary>
         <value>The name for the <see cref="T:System.Net.Cookie" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Cookie.Name%2A> property must be initialized before using an instance of the <xref:System.Net.Cookie> class.  
-  
- The following characters are reserved and cannot be used for this attribute value: equal sign, semicolon, comma, new line (\n), return (\r), tab (\t), and space character. The dollar sign ($) character cannot be the first character.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Cookie.Name%2A> property must be initialized before using an instance of the <xref:System.Net.Cookie> class.
+
+ The following characters are reserved and cannot be used for this attribute value: equal sign, semicolon, comma, new line (\n), return (\r), tab (\t), and space character. The dollar sign ($) character cannot be the first character.
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
-        <exception cref="T:System.Net.CookieException">The value specified for a set operation is <see langword="null" /> or the empty string  
-  
+        <exception cref="T:System.Net.CookieException">The value specified for a set operation is <see langword="null" /> or the empty string
+
 -or-
-  
+
  The value specified for a set operation contained an illegal character. The following characters must not be used inside the <see cref="P:System.Net.Cookie.Name" /> property: equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character.</exception>
         <altmember cref="T:System.Net.CookieCollection" />
         <altmember cref="T:System.Net.CookieContainer" />
@@ -1199,20 +1197,20 @@
         <summary>Gets or sets the URIs to which the <see cref="T:System.Net.Cookie" /> applies.</summary>
         <value>The URIs to which the <see cref="T:System.Net.Cookie" /> applies.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Cookie.Path%2A> property specifies the subset of URIs on the origin server to which this <xref:System.Net.Cookie> applies. If this property is not specified, then this <xref:System.Net.Cookie> will be sent to all pages on the origin server or servers.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Cookie.Path%2A> property specifies the subset of URIs on the origin server to which this <xref:System.Net.Cookie> applies. If this property is not specified, then this <xref:System.Net.Cookie> will be sent to all pages on the origin server or servers.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -1270,20 +1268,20 @@
         <summary>Gets or sets a list of TCP ports that the <see cref="T:System.Net.Cookie" /> applies to.</summary>
         <value>The list of TCP ports that the <see cref="T:System.Net.Cookie" /> applies to.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This attribute restricts the ports to which this <xref:System.Net.Cookie> may be sent. The default value means no restriction. Setting this to the empty string ("") will restrict the port to the one used in the HTTP response. Otherwise, the value must be a double-quoted string that contains port values delimited with commas.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This attribute restricts the ports to which this <xref:System.Net.Cookie> may be sent. The default value means no restriction. Setting this to the empty string ("") will restrict the port to the one used in the HTTP response. Otherwise, the value must be a double-quoted string that contains port values delimited with commas.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.Net.CookieException">The value specified for a set operation could not be parsed or is not enclosed in double quotes.</exception>
@@ -1347,20 +1345,20 @@
         <value>
           <see langword="true" /> if the client is only to return the cookie in subsequent requests if those requests use Secure Hypertext Transfer Protocol (HTTPS); otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- In effect, when this property is `true` this cookie may be sent only with https:// requests.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ In effect, when this property is `true` this cookie may be sent only with https:// requests.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -1418,20 +1416,20 @@
         <summary>Gets the time when the cookie was issued as a <see cref="T:System.DateTime" />.</summary>
         <value>The time when the cookie was issued as a <see cref="T:System.DateTime" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This is a read-only property.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This is a read-only property.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -1484,20 +1482,20 @@
         <summary>Overrides the <see cref="M:System.Object.ToString" /> method.</summary>
         <returns>Returns a string representation of this <see cref="T:System.Net.Cookie" /> object that is suitable for including in a HTTP Cookie: request header.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The exact format of the string depends on the RFC that this cookie conforms to.  
-  
-   
-  
-## Examples  
- The following example displays the string value of a cookie returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The exact format of the string depends on the RFC that this cookie conforms to.
+
+
+
+## Examples
+ The following example displays the string value of a cookie returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet4":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet4":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet4":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet4":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -1552,22 +1550,22 @@
         <summary>Gets or sets the <see cref="P:System.Net.Cookie.Value" /> for the <see cref="T:System.Net.Cookie" />.</summary>
         <value>The <see cref="P:System.Net.Cookie.Value" /> for the <see cref="T:System.Net.Cookie" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Cookie.Value%2A> of a <xref:System.Net.Cookie> must not be `null`. If a `null` value is assigned to this property, it's replaced with an empty string. 
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Cookie.Value%2A> of a <xref:System.Net.Cookie> must not be `null`. If a `null` value is assigned to this property, it's replaced with an empty string.
 
  Semicolons and commas are reserved characters that cannot be used in the value of this property. Assigning invalid characters to this property doesn't throw an exception; but when you try to add this <xref:System.Net.Cookie> to a <xref:System.Net.CookieContainer> instance with the <xref:System.Net.CookieContainer.Add%2A> method, the operation will fail and throw an exception.
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Net.CookieCollection" />
@@ -1625,22 +1623,22 @@
         <summary>Gets or sets the version of HTTP state maintenance to which the cookie conforms.</summary>
         <value>The version of HTTP state maintenance to which the cookie conforms.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The default value for the <xref:System.Net.Cookie.Version%2A> property is 0, complying with the original Netscape specification. If the value is explicitly set to 1, then this <xref:System.Net.Cookie> must conform to RFC 2109. Note that if a <xref:System.Net.Cookie> was created automatically by receiving a Set-Cookie2 HTTP response header, the conformance is set to RFC 2965.  
-  
- An attempt to set the <xref:System.Net.Cookie.Version%2A> property to a value less than zero will throw an exception.  
-  
-   
-  
-## Examples  
- The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The default value for the <xref:System.Net.Cookie.Version%2A> property is 0, complying with the original Netscape specification. If the value is explicitly set to 1, then this <xref:System.Net.Cookie> must conform to RFC 2109. Note that if a <xref:System.Net.Cookie> was created automatically by receiving a Set-Cookie2 HTTP response header, the conformance is set to RFC 2965.
+
+ An attempt to set the <xref:System.Net.Cookie.Version%2A> property to a value less than zero will throw an exception.
+
+
+
+## Examples
+ The following example displays the properties of cookies returned in a response. For the complete example, see the <xref:System.Net.Cookie> class topic.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLCookies/CPP/cookiessnippets.cpp" id="Snippet3":::
  :::code language="csharp" source="~/snippets/csharp/System.Net/Cookie/Overview/cookiessnippets.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NCLCookies/VB/cookiessnippets.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a version is not allowed.</exception>
diff --git a/xml/System.Net/CookieException.xml b/xml/System.Net/CookieException.xml
index a22f6aaf715..bb4c39b8a33 100644
--- a/xml/System.Net/CookieException.xml
+++ b/xml/System.Net/CookieException.xml
@@ -69,7 +69,7 @@
 ## Remarks
  This exception is thrown if an attempt is made to <xref:System.Net.CookieContainer.Add%2A> a <xref:System.Net.Cookie> with length greater than <xref:System.Net.CookieContainer.MaxCookieSize%2A> to a <xref:System.Net.CookieContainer>.
 
- **Associated Tips**
+### Tips
 
  **Make sure the cookie size does not exceed the maximum allowed by the cookie container.**
  This exception is thrown when an attempt is made to add a <xref:System.Net.Cookie> with length greater than <xref:System.Net.CookieContainer.MaxCookieSize%2A> to a <xref:System.Net.CookieContainer>. The default maximum cookie size is 4096 bytes.
diff --git a/xml/System.Security.Policy/CodeConnectAccess.xml b/xml/System.Security.Policy/CodeConnectAccess.xml
index e2ebbe6c698..26a894b1225 100644
--- a/xml/System.Security.Policy/CodeConnectAccess.xml
+++ b/xml/System.Security.Policy/CodeConnectAccess.xml
@@ -40,23 +40,23 @@
   <Docs>
     <summary>Specifies the network resource access that is granted to code.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This class is used in conjunction with the <xref:System.Security.Policy.NetCodeGroup> class to control how executing code can connect back to the site it was downloaded from. These classes provide programmatic control of the <xref:System.Net.WebPermission> granted to executing code that controls what schemes and ports the code can use access its origin site. You can specify scheme and port pairs that are permitted based on the scheme in the URL where the code originates.  
-  
- To create a <xref:System.Security.Policy.CodeConnectAccess> object based on the code's origin scheme, use the <xref:System.Security.Policy.CodeConnectAccess.CreateOriginSchemeAccess%2A> method.  
-  
- To create a <xref:System.Security.Policy.CodeConnectAccess> object that can use any scheme but is restricted by port, use the <xref:System.Security.Policy.CodeConnectAccess.CreateAnySchemeAccess%2A> method.  
-  
-   
-  
-## Examples  
- The following code example creates a <xref:System.Security.Policy.NetCodeGroup> object and adds it to the User policy level.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This class is used in conjunction with the <xref:System.Security.Policy.NetCodeGroup> class to control how executing code can connect back to the site it was downloaded from. These classes provide programmatic control of the <xref:System.Net.WebPermission> granted to executing code that controls what schemes and ports the code can use access its origin site. You can specify scheme and port pairs that are permitted based on the scheme in the URL where the code originates.
+
+ To create a <xref:System.Security.Policy.CodeConnectAccess> object based on the code's origin scheme, use the <xref:System.Security.Policy.CodeConnectAccess.CreateOriginSchemeAccess%2A> method.
+
+ To create a <xref:System.Security.Policy.CodeConnectAccess> object that can use any scheme but is restricted by port, use the <xref:System.Security.Policy.CodeConnectAccess.CreateAnySchemeAccess%2A> method.
+
+
+
+## Examples
+ The following code example creates a <xref:System.Security.Policy.NetCodeGroup> object and adds it to the User policy level.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet3":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet3":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet3":::
+
  ]]></format>
     </remarks>
   </Docs>
@@ -94,40 +94,40 @@
         <param name="allowPort">The port represented by the current instance.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Policy.CodeConnectAccess" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Security.Policy.CodeConnectAccess.Scheme%2A> property is set using the `allowScheme` parameter. The scheme is converted to lowercase. The value of <xref:System.Security.Policy.CodeConnectAccess.Scheme%2A> controls the scheme that executing code can use to connect to a network resource.  
-  
- The <xref:System.Security.Policy.CodeConnectAccess.Port%2A> property is set using the `allowPort` parameter. The value of <xref:System.Security.Policy.CodeConnectAccess.Port%2A> controls the port that executing code can use to connect to a network resource.  
-  
-   
-  
-## Examples  
- The following code example demonstrates creating a <xref:System.Security.Policy.CodeConnectAccess> object that permits downloaded code to connect back to its origin server using the HTTP protocol and the same port it was downloaded on. For an example that demonstrates using <xref:System.Security.Policy.CodeConnectAccess> objects to create a code group and adding the code group to a policy level, see the <xref:System.Security.Policy.CodeConnectAccess> class overview.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Security.Policy.CodeConnectAccess.Scheme%2A> property is set using the `allowScheme` parameter. The scheme is converted to lowercase. The value of <xref:System.Security.Policy.CodeConnectAccess.Scheme%2A> controls the scheme that executing code can use to connect to a network resource.
+
+ The <xref:System.Security.Policy.CodeConnectAccess.Port%2A> property is set using the `allowPort` parameter. The value of <xref:System.Security.Policy.CodeConnectAccess.Port%2A> controls the port that executing code can use to connect to a network resource.
+
+
+
+## Examples
+ The following code example demonstrates creating a <xref:System.Security.Policy.CodeConnectAccess> object that permits downloaded code to connect back to its origin server using the HTTP protocol and the same port it was downloaded on. For an example that demonstrates using <xref:System.Security.Policy.CodeConnectAccess> objects to create a code group and adding the code group to a policy level, see the <xref:System.Security.Policy.CodeConnectAccess> class overview.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet2":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet2":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet2":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="allowScheme" /> is <see langword="null" />.  
-  
- -or-  
-  
- <paramref name="allowScheme" /> is an empty string ("").  
-  
- -or-  
-  
- <paramref name="allowScheme" /> contains characters that are not permitted in schemes.  
-  
- -or-  
-  
- <paramref name="allowPort" /> is less than 0.  
-  
- -or-  
-  
+          <paramref name="allowScheme" /> is <see langword="null" />.
+
+ -or-
+
+ <paramref name="allowScheme" /> is an empty string ("").
+
+ -or-
+
+ <paramref name="allowScheme" /> contains characters that are not permitted in schemes.
+
+ -or-
+
+ <paramref name="allowPort" /> is less than 0.
+
+ -or-
+
  <paramref name="allowPort" /> is greater than 65,535.</exception>
       </Docs>
     </Member>
@@ -161,21 +161,21 @@
       <Docs>
         <summary>Contains the string value that represents the scheme wildcard.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- As an alternative to constructing a <xref:System.Security.Policy.CodeConnectAccess> object using this value, you can call the <xref:System.Security.Policy.CodeConnectAccess.CreateAnySchemeAccess%2A> method to obtain a <xref:System.Security.Policy.CodeConnectAccess> object that represents a specified port and any scheme.  
-  
- The value of this field is "*".  
-  
-   
-  
-## Examples  
- The following code example displays the value of this field.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ As an alternative to constructing a <xref:System.Security.Policy.CodeConnectAccess> object using this value, you can call the <xref:System.Security.Policy.CodeConnectAccess.CreateAnySchemeAccess%2A> method to obtain a <xref:System.Security.Policy.CodeConnectAccess> object that represents a specified port and any scheme.
+
+ The value of this field is "*".
+
+
+
+## Examples
+ The following code example displays the value of this field.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet6":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet6":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet6":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -215,26 +215,26 @@
         <summary>Returns a <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance that represents access to the specified port using any scheme.</summary>
         <returns>A <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance for the specified port.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Security.Policy.CodeConnectAccess> instance returned by this method uses the scheme wildcard value <xref:System.Security.Policy.CodeConnectAccess.AnyScheme> ("*") to represent the scheme.  
-  
-   
-  
-## Examples  
- The following code example demonstrates calling this method. For an example that demonstrates using <xref:System.Security.Policy.CodeConnectAccess> objects to create a code group and adding the code group to a policy level, see the <xref:System.Security.Policy.CodeConnectAccess> class overview.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Security.Policy.CodeConnectAccess> instance returned by this method uses the scheme wildcard value <xref:System.Security.Policy.CodeConnectAccess.AnyScheme> ("*") to represent the scheme.
+
+
+
+## Examples
+ The following code example demonstrates calling this method. For an example that demonstrates using <xref:System.Security.Policy.CodeConnectAccess> objects to create a code group and adding the code group to a policy level, see the <xref:System.Security.Policy.CodeConnectAccess> class overview.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet5":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet5":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet5":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="allowPort" /> is less than 0.  
-  
- -or-  
-  
+          <paramref name="allowPort" /> is less than 0.
+
+ -or-
+
  <paramref name="allowPort" /> is greater than 65,535.</exception>
       </Docs>
     </Member>
@@ -273,26 +273,26 @@
         <summary>Returns a <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance that represents access to the specified port using the code's scheme of origin.</summary>
         <returns>A <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance for the specified port.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Security.Policy.CodeConnectAccess> instance returned by this method has the scheme value <xref:System.Security.Policy.CodeConnectAccess.OriginScheme>. The origin scheme is the scheme value from the URI where the code originated.  
-  
-   
-  
-## Examples  
- The following code example demonstrates using <xref:System.Security.Policy.CodeConnectAccess> objects to create a code group and adding the code group to a policy level.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Security.Policy.CodeConnectAccess> instance returned by this method has the scheme value <xref:System.Security.Policy.CodeConnectAccess.OriginScheme>. The origin scheme is the scheme value from the URI where the code originated.
+
+
+
+## Examples
+ The following code example demonstrates using <xref:System.Security.Policy.CodeConnectAccess> objects to create a code group and adding the code group to a policy level.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet3":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet3":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="allowPort" /> is less than 0.  
-  
- -or-  
-  
+          <paramref name="allowPort" /> is less than 0.
+
+ -or-
+
  <paramref name="allowPort" /> is greater than 65,535.</exception>
       </Docs>
     </Member>
@@ -326,21 +326,21 @@
       <Docs>
         <summary>Contains the value used to represent the default port.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To create a <xref:System.Security.Policy.CodeConnectAccess> object that has the default port for a specified scheme, use this field as the `allowPort` parameter of the <xref:System.Security.Policy.CodeConnectAccess.%23ctor%2A> constructor.  
-  
- The value of this field is -3.  
-  
-   
-  
-## Examples  
- The following code example demonstrates creating a <xref:System.Security.Policy.CodeConnectAccess> object that specifies FTP for the scheme and the default port for FTP.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To create a <xref:System.Security.Policy.CodeConnectAccess> object that has the default port for a specified scheme, use this field as the `allowPort` parameter of the <xref:System.Security.Policy.CodeConnectAccess.%23ctor%2A> constructor.
+
+ The value of this field is -3.
+
+
+
+## Examples
+ The following code example demonstrates creating a <xref:System.Security.Policy.CodeConnectAccess> object that specifies FTP for the scheme and the default port for FTP.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet1":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet1":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet1":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -381,11 +381,11 @@
         <returns>
           <see langword="true" /> if the two objects represent the same scheme and port; otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Two <xref:System.Security.Policy.CodeConnectAccess> objects are equal if their <xref:System.Security.Policy.CodeConnectAccess.Scheme%2A> and <xref:System.Security.Policy.CodeConnectAccess.Port%2A> property values are equal.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Two <xref:System.Security.Policy.CodeConnectAccess> objects are equal if their <xref:System.Security.Policy.CodeConnectAccess.Scheme%2A> and <xref:System.Security.Policy.CodeConnectAccess.Port%2A> property values are equal.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -455,21 +455,21 @@
       <Docs>
         <summary>Contains the value used to represent the port value in the URI where code originated.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To create a <xref:System.Security.Policy.CodeConnectAccess> object that has the same port as the port in the executing code's URL evidence, use this field as the `allowPort` parameter of the <xref:System.Security.Policy.CodeConnectAccess.%23ctor%2A> constructor.  
-  
- The value of this field is -4.  
-  
-   
-  
-## Examples  
- The following code example demonstrates creating a <xref:System.Security.Policy.CodeConnectAccess> object that specifies the HTTP scheme and origin port.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To create a <xref:System.Security.Policy.CodeConnectAccess> object that has the same port as the port in the executing code's URL evidence, use this field as the `allowPort` parameter of the <xref:System.Security.Policy.CodeConnectAccess.%23ctor%2A> constructor.
+
+ The value of this field is -4.
+
+
+
+## Examples
+ The following code example demonstrates creating a <xref:System.Security.Policy.CodeConnectAccess> object that specifies the HTTP scheme and origin port.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet2":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet2":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet2":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -504,21 +504,19 @@
       <Docs>
         <summary>Contains the value used to represent the scheme in the URL where the code originated.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Do not use this field with the <xref:System.Security.Policy.CodeConnectAccess.%23ctor%2A> constructor. Instead, use the <xref:System.Security.Policy.CodeConnectAccess.CreateOriginSchemeAccess%2A> method.  
-  
- The value of this field is "$origin".  
-  
-   
-  
-## Examples  
- The following code example displays the value of this field.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Do not use this field with the <xref:System.Security.Policy.CodeConnectAccess.%23ctor%2A> constructor. Instead, use the <xref:System.Security.Policy.CodeConnectAccess.CreateOriginSchemeAccess%2A> method.
+
+ The value of this field is "$origin".
+
+## Examples
+ The following code example displays the value of this field.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet6":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet6":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet6":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -554,19 +552,19 @@
         <summary>Gets the port represented by the current instance.</summary>
         <value>A <see cref="T:System.Int32" /> value that identifies a computer port used in conjunction with the <see cref="P:System.Security.Policy.CodeConnectAccess.Scheme" /> property.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Port values are between 0 and 65,535. The port value is specified when you create an instance of <xref:System.Security.Policy.CodeConnectAccess>.  
-  
-   
-  
-## Examples  
- The following code example demonstrates displaying the value of this property.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Port values are between 0 and 65,535. The port value is specified when you create an instance of <xref:System.Security.Policy.CodeConnectAccess>.
+
+
+
+## Examples
+ The following code example demonstrates displaying the value of this property.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet4":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet4":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet4":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -602,19 +600,19 @@
         <summary>Gets the URI scheme represented by the current instance.</summary>
         <value>A <see cref="T:System.String" /> that identifies a URI scheme, converted to lowercase.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The scheme value is specified when you create an instance of <xref:System.Security.Policy.CodeConnectAccess>.  
-  
-   
-  
-## Examples  
- The following code example demonstrates displaying the value of this property.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The scheme value is specified when you create an instance of <xref:System.Security.Policy.CodeConnectAccess>.
+
+
+
+## Examples
+ The following code example demonstrates displaying the value of this property.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclCodeGroup/cpp/sample.cpp" id="Snippet4":::
- :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet4":::  
-  
+ :::code language="csharp" source="~/snippets/csharp/System.Security.Policy/CodeConnectAccess/Overview/sample.cs" id="Snippet4":::
+
  ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Speech.Recognition.SrgsGrammar/SrgsRule.xml b/xml/System.Speech.Recognition.SrgsGrammar/SrgsRule.xml
index 42ddd64befa..8e22744d1ef 100644
--- a/xml/System.Speech.Recognition.SrgsGrammar/SrgsRule.xml
+++ b/xml/System.Speech.Recognition.SrgsGrammar/SrgsRule.xml
@@ -97,8 +97,6 @@
 
 -   `id` contains at least one invalid rule ID character. These characters are: '?', '*', '+', '&#124;', '(', '), '^', '$', '/', ';', '.', '=', '\<', '>', '[', ']', '{', '}', '\\\\', ' ', '\t', '\r', and '\n'.
 
-
-
 ## Examples
  The following example creates a grammar that recognizes the phrase "A nation that has won the World Cup is" followed by the name of a country that has won the World Cup. The example creates a <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule> object named `winnerRule` and passes in the identifier  `WorldCupWinner` as a <xref:System.String>. The <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object consists of an array of new <xref:System.Speech.Recognition.SrgsGrammar.SrgsItem> objects containing alternatives to be recognized by the rule.
 
@@ -190,8 +188,6 @@ public void WorldSoccerWinners ()
 
 -   `id` contains at least one invalid rule ID character. These characters are: '?', '*', '+', '&#124;', '(', '), '^', '$', '/', ';', '.', '=', '\<', '>', '[', ']', '{', '}', '\\\\', ' ', '\t', '\r', and '\n'.
 
-
-
 ## Examples
  The following example creates a grammar that recognizes the phrase "A nation that has won the World Cup is" followed by the name of a country that has won the World Cup. The example creates a public rule named `WorldCupWinner`. The example then creates two <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule> objects, `ruleEurope` and  `ruleSAmerica`, passing in a <xref:System.String> for the rule identifier and an <xref:System.Speech.Recognition.SrgsGrammar.SrgsElement> array containing a <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf> object. Subsequently, the example adds rule references to `ruleEurope` and `ruleSAmerica` from the rule `WorldCupWinner`.
 
@@ -446,11 +442,11 @@ document.Root = winnerRule;
 
  A value used to set <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule.Id%2A> must adhere to the following rules:
 
--   The value must be a valid XML name, as defined in [Extensible Markup Language (XML) 1.0 (Fifth Edition)](https://www.w3.org/TR/REC-xml/). To paraphrase this definition, a valid XML name must begin with a letter, an underscore ('_'), or a colon (':') and can be followed by zero or more NameChar characters (also defined in the XML specification).
+- The value must be a valid XML name, as defined in [Extensible Markup Language (XML) 1.0 (Fifth Edition)](https://www.w3.org/TR/REC-xml/). To paraphrase this definition, a valid XML name must begin with a letter, an underscore ('_'), or a colon (':') and can be followed by zero or more NameChar characters (also defined in the XML specification).
 
--   The value can be "NULL" or "VOID" or "GARBAGE".
+- The value can be "NULL" or "VOID" or "GARBAGE".
 
--   The value cannot contain any invalid rule ID character. These characters are: '?', '*', '+', '&#124;', '(', '), '^', '$', '/', ';', '.', '=', '\<', '>', '[', ']', '{', '}', '\\\\', ' ', '\t', '\r', and '\n'.
+- The value cannot contain any invalid rule ID character. These characters are: '?', '*', '+', '&#124;', '(', '), '^', '$', '/', ';', '.', '=', '\<', '>', '[', ']', '{', '}', '\\\\', ' ', '\t', '\r', and '\n'.
 
  ]]></format>
         </remarks>
diff --git a/xml/System.Speech.Recognition/RecognizedWordUnit.xml b/xml/System.Speech.Recognition/RecognizedWordUnit.xml
index 38928898cce..c7102aefc54 100644
--- a/xml/System.Speech.Recognition/RecognizedWordUnit.xml
+++ b/xml/System.Speech.Recognition/RecognizedWordUnit.xml
@@ -30,86 +30,86 @@
   <Docs>
     <summary>Provides the atomic unit of recognized speech.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- All results returned by a recognition engine are constructed of <xref:System.Speech.Recognition.RecognizedWordUnit> objects.  
-  
- An array of <xref:System.Speech.Recognition.RecognizedWordUnit> objects is accessible for any recognition operation through the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
- In addition to providing a measure of recognition certainty (<xref:System.Speech.Recognition.RecognizedWordUnit.Confidence%2A>) a <xref:System.Speech.Recognition.RecognizedWordUnit> instance provides:  
-  
--   Normalized and exact (or lexical) text representations for a recognized word. For more information, see <xref:System.Speech.Recognition.ReplacementText>, <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>, and <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>.  
-  
--   Pronunciation information using characters from a supported phonetic alphabet, such as the International Phonetic Alphabet (IPA) or the Universal Phone Set (UPS). For more information see <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>.  
-  
--   Formatting for printing. For more information see the <xref:System.Speech.Recognition.DisplayAttributes> class and its <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property.  
-  
-   
-  
-## Examples  
- The following example shows a utility routine (`stringFromWordArray`) that generates strings. The strings contain lexical output (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized text (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), or phonetic characters from the International Phonetic Alphabet (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). Strings are formatted using <xref:System.Speech.Recognition.DisplayAttributes> objects obtained from the <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects. The <xref:System.Speech.Recognition.RecognizedWordUnit> objects are obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
-```csharp  
-  
-internal enum WordType   
-{  
-  Text,  
-  Normalized = Text,  
-  Lexical,  
-  Pronunciation  
-}  
-```  
-  
-```csharp  
-internal static string stringFromWordArray(ReadOnlyCollection<RecognizedWordUnit> words, WordType type)   
-{  
-  string text = "";  
-  foreach (RecognizedWordUnit word in words)   
-  {  
-    string wordText = "";  
-    if (type == WordType.Text || type == WordType.Normalized)   
-    {  
-      wordText = word.Text;  
-    }   
-    else if (type == WordType.Lexical)   
-    {  
-      wordText = word.LexicalForm;  
-    }   
-    else if (type == WordType.Pronunciation)   
-    {  
-      wordText = word.Pronunciation;  
-    }   
-    else   
-    {  
-      throw new InvalidEnumArgumentException(String.Format("[0}: is not a valid input", type));  
-    }  
-    // Use display attribute  
-  
-    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)   
-    {  
-      wordText += " ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)  
-    {  
-      wordText += "  ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimStart();  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)  
-    {  
-      wordText = wordText.TrimEnd();  
-    }  
-  
-    text += wordText;  
-  
-  }  
-  return text;  
-}  
-```  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ All results returned by a recognition engine are constructed of <xref:System.Speech.Recognition.RecognizedWordUnit> objects.
+
+ An array of <xref:System.Speech.Recognition.RecognizedWordUnit> objects is accessible for any recognition operation through the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+ In addition to providing a measure of recognition certainty (<xref:System.Speech.Recognition.RecognizedWordUnit.Confidence%2A>) a <xref:System.Speech.Recognition.RecognizedWordUnit> instance provides:
+
+-   Normalized and exact (or lexical) text representations for a recognized word. For more information, see <xref:System.Speech.Recognition.ReplacementText>, <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>, and <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>.
+
+-   Pronunciation information using characters from a supported phonetic alphabet, such as the International Phonetic Alphabet (IPA) or the Universal Phone Set (UPS). For more information see <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>.
+
+-   Formatting for printing. For more information see the <xref:System.Speech.Recognition.DisplayAttributes> class and its <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property.
+
+
+
+## Examples
+ The following example shows a utility routine (`stringFromWordArray`) that generates strings. The strings contain lexical output (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized text (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), or phonetic characters from the International Phonetic Alphabet (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). Strings are formatted using <xref:System.Speech.Recognition.DisplayAttributes> objects obtained from the <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects. The <xref:System.Speech.Recognition.RecognizedWordUnit> objects are obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+```csharp
+
+internal enum WordType
+{
+  Text,
+  Normalized = Text,
+  Lexical,
+  Pronunciation
+}
+```
+
+```csharp
+internal static string stringFromWordArray(ReadOnlyCollection<RecognizedWordUnit> words, WordType type)
+{
+  string text = "";
+  foreach (RecognizedWordUnit word in words)
+  {
+    string wordText = "";
+    if (type == WordType.Text || type == WordType.Normalized)
+    {
+      wordText = word.Text;
+    }
+    else if (type == WordType.Lexical)
+    {
+      wordText = word.LexicalForm;
+    }
+    else if (type == WordType.Pronunciation)
+    {
+      wordText = word.Pronunciation;
+    }
+    else
+    {
+      throw new InvalidEnumArgumentException(String.Format("[0}: is not a valid input", type));
+    }
+    // Use display attribute
+
+    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)
+    {
+      wordText += " ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)
+    {
+      wordText += "  ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)
+    {
+      wordText = wordText.TrimStart();
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)
+    {
+      wordText = wordText.TrimEnd();
+    }
+
+    text += wordText;
+
+  }
+  return text;
+}
+```
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.Speech.Recognition.DisplayAttributes" />
@@ -139,88 +139,88 @@ internal static string stringFromWordArray(ReadOnlyCollection<RecognizedWordUnit
         <Parameter Name="audioDuration" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <param name="text">The normalized text for a recognized word.  
-  
+        <param name="text">The normalized text for a recognized word.
+
  This value can be <see langword="null" />, "", or <see cref="F:System.String.Empty" />.</param>
         <param name="confidence">A <see langword="float" /> value from 0.0 through 1.0 indicating the certainty of word recognition.</param>
-        <param name="pronunciation">The phonetic spelling of a recognized word.  
-  
+        <param name="pronunciation">The phonetic spelling of a recognized word.
+
  This value can be <see langword="null" />, "", or <see cref="F:System.String.Empty" />.</param>
-        <param name="lexicalForm">The unnormalized text for a recognized word.  
-  
+        <param name="lexicalForm">The unnormalized text for a recognized word.
+
  This argument is required and may not be <see langword="null" />, "", or <see cref="F:System.String.Empty" />.</param>
         <param name="displayAttributes">Defines the use of white space to display recognized words.</param>
-        <param name="audioPosition">The location of the recognized word in the audio input stream.  
-  
+        <param name="audioPosition">The location of the recognized word in the audio input stream.
+
  This value can be <see cref="F:System.TimeSpan.Zero" />.</param>
-        <param name="audioDuration">The length of the audio input corresponding to the recognized word.  
-  
+        <param name="audioDuration">The length of the audio input corresponding to the recognized word.
+
  This value can be <see cref="F:System.TimeSpan.Zero" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Speech.Recognition.RecognizedWordUnit" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If `text` or `pronunciation` are `null`, "", or <xref:System.String.Empty> and the <xref:System.Speech.Recognition.RecognizedWordUnit> is used in a recognition operation, the recognition engine will generate appropriate values in any output <xref:System.Speech.Recognition.RecognizedWordUnit> instance.  
-  
- Direct construction of <xref:System.Speech.Recognition.RecognizedWordUnit> instances is typically used only when emulating recognition operations using the <xref:System.Speech.Recognition.SpeechRecognitionEngine.EmulateRecognize%2A> or <xref:System.Speech.Recognition.SpeechRecognitionEngine.EmulateRecognizeAsync%2A> methods of the <xref:System.Speech.Recognition.SpeechRecognitionEngine> class and the <xref:System.Speech.Recognition.SpeechRecognizer.EmulateRecognize%2A> or <xref:System.Speech.Recognition.SpeechRecognizer.EmulateRecognizeAsync%2A> methods of the <xref:System.Speech.Recognition.SpeechRecognizer> class.  
-  
- For actual applications, do not directly construct <xref:System.Speech.Recognition.RecognizedWordUnit>, rather obtain it through the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
-   
-  
-## Examples  
- The following example is a somewhat contrived test of emulation, where new words are generated from the input and passed to the emulator, and then verified.  
-  
-```csharp  
-private void _emulateAndVerify_Click(object sender, EventArgs e)   
-{  
-  char[] delimiterChars = { ' ', ',', '.', ':', ';', '\t' };  
-  string text = _emulateTextBox.Text;  
-  string[] words = text.Split(delimiterChars);  
-  
-  RecognizedWordUnit[] InputWordUnits = new RecognizedWordUnit[words.Length];  
-  for (int i = 0; i < words.Length; i++)   
-  {  
-    InputWordUnits[i] = new RecognizedWordUnit(  
-        "",   
-        0,   
-        "",  
-        words[i].ToLower(),   
-        DisplayAttributes.OneTrailingSpace,   
-        new TimeSpan(),   
-        new TimeSpan());  
-  }  
-  
-  RecognitionResult rec = _recognizer.EmulateRecognize(  
-        InputWordUnits,   
-        System.Globalization.CompareOptions.IgnoreCase);  
-  if (rec == null)   
-  {  
-    MessageBox.Show(String.Format("Recognition emulation for {0} failed.\n", text));  
-  }   
-  else if (InputWordUnits.Length != rec.Words.Count)   
-  {  
-    MessageBox.Show(  
-       String.Format("Length mismatch: Input was {0} words, Recognition has {1} words.\n}"));  
-  }   
-  else   
-  {  
-    for (int i = 0; i < InputWordUnits.Length; i++)   
-    {  
-  
-      if (rec.Words[i].LexicalForm.ToLower() != InputWordUnits[i].LexicalForm.ToLower())   
-      {  
-        MessageBox.Show(  
-          String.Format("Input word {0} \"{1}\" not found. Recognition output is {2}",  
-          i, InputWordUnits[i].LexicalForm, rec.Words[i].LexicalForm));  
-        continue;  
-      }  
-    }  
-  }  
-}  
-```  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ If `text` or `pronunciation` are `null`, "", or <xref:System.String.Empty> and the <xref:System.Speech.Recognition.RecognizedWordUnit> is used in a recognition operation, the recognition engine will generate appropriate values in any output <xref:System.Speech.Recognition.RecognizedWordUnit> instance.
+
+ Direct construction of <xref:System.Speech.Recognition.RecognizedWordUnit> instances is typically used only when emulating recognition operations using the <xref:System.Speech.Recognition.SpeechRecognitionEngine.EmulateRecognize%2A> or <xref:System.Speech.Recognition.SpeechRecognitionEngine.EmulateRecognizeAsync%2A> methods of the <xref:System.Speech.Recognition.SpeechRecognitionEngine> class and the <xref:System.Speech.Recognition.SpeechRecognizer.EmulateRecognize%2A> or <xref:System.Speech.Recognition.SpeechRecognizer.EmulateRecognizeAsync%2A> methods of the <xref:System.Speech.Recognition.SpeechRecognizer> class.
+
+ For actual applications, do not directly construct <xref:System.Speech.Recognition.RecognizedWordUnit>, rather obtain it through the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+
+
+## Examples
+ The following example is a somewhat contrived test of emulation, where new words are generated from the input and passed to the emulator, and then verified.
+
+```csharp
+private void _emulateAndVerify_Click(object sender, EventArgs e)
+{
+  char[] delimiterChars = { ' ', ',', '.', ':', ';', '\t' };
+  string text = _emulateTextBox.Text;
+  string[] words = text.Split(delimiterChars);
+
+  RecognizedWordUnit[] InputWordUnits = new RecognizedWordUnit[words.Length];
+  for (int i = 0; i < words.Length; i++)
+  {
+    InputWordUnits[i] = new RecognizedWordUnit(
+        "",
+        0,
+        "",
+        words[i].ToLower(),
+        DisplayAttributes.OneTrailingSpace,
+        new TimeSpan(),
+        new TimeSpan());
+  }
+
+  RecognitionResult rec = _recognizer.EmulateRecognize(
+        InputWordUnits,
+        System.Globalization.CompareOptions.IgnoreCase);
+  if (rec == null)
+  {
+    MessageBox.Show(String.Format("Recognition emulation for {0} failed.\n", text));
+  }
+  else if (InputWordUnits.Length != rec.Words.Count)
+  {
+    MessageBox.Show(
+       String.Format("Length mismatch: Input was {0} words, Recognition has {1} words.\n}"));
+  }
+  else
+  {
+    for (int i = 0; i < InputWordUnits.Length; i++)
+    {
+
+      if (rec.Words[i].LexicalForm.ToLower() != InputWordUnits[i].LexicalForm.ToLower())
+      {
+        MessageBox.Show(
+          String.Format("Input word {0} \"{1}\" not found. Recognition output is {2}",
+          i, InputWordUnits[i].LexicalForm, rec.Words[i].LexicalForm));
+        continue;
+      }
+    }
+  }
+}
+```
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Speech.Recognition.DisplayAttributes" />
@@ -254,17 +254,17 @@ private void _emulateAndVerify_Click(object sender, EventArgs e)
         <summary>Gets a value, assigned by the recognizer, that represents the likelihood that a recognized word matches a given input.</summary>
         <value>A relative measure of the certainty of correct recognition for a word. The value is from 0.0 to 1.0, for low to high confidence, respectively.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Confidence scores do not indicate the absolute likelihood that a word was recognized correctly. Instead, confidence scores provide a mechanism for comparing the relative accuracy of multiple recognition alternates for a given input. This facilitates returning the most accurate recognition result. For example, if a recognized word has a confidence score of 0.8, this does not mean that the word has an 80% chance of being the correct match for the input.  It means that the word is more likely to be the correct match for the input than other results that have confidence scores less than 0.8.  
-  
- A confidence score on its own is not meaningful unless you have alternative results to compare against, either from the same recognition operation or from previous recognitions of the same input.  
-  
- The values returned by <xref:System.Speech.Recognition.RecognizedWordUnit.Confidence%2A> are relative and unique to each recognition engine. There is no definition of how confidence values between two different recognition engines compare, nor how the <xref:System.Speech.Recognition.RecognizedWordUnit.Confidence%2A> of individual <xref:System.Speech.Recognition.RecognizedWordUnit> objects define the <xref:System.Speech.Recognition.RecognizedPhrase.Confidence%2A> of a <xref:System.Speech.Recognition.RecognizedPhrase>.  
-  
- A speech recognition engine may assign a low confidence score to spoken input for various reasons, including background interference, inarticulate speech, or unanticipated words or word sequences. If your application is using a <xref:System.Speech.Recognition.SpeechRecognitionEngine> instance, you can modify the confidence level at which speech input is accepted or rejected with one of the <xref:System.Speech.Recognition.SpeechRecognitionEngine.UpdateRecognizerSetting%2A> methods. Confidence thresholds for the shared recognizer, managed by <xref:System.Speech.Recognition.SpeechRecognizer>, are associated with a user profile and stored in the Windows registry. Applications should not write changes to the registry for the properties of the shared recognizer.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Confidence scores do not indicate the absolute likelihood that a word was recognized correctly. Instead, confidence scores provide a mechanism for comparing the relative accuracy of multiple recognition alternates for a given input. This facilitates returning the most accurate recognition result. For example, if a recognized word has a confidence score of 0.8, this does not mean that the word has an 80% chance of being the correct match for the input.  It means that the word is more likely to be the correct match for the input than other results that have confidence scores less than 0.8.
+
+ A confidence score on its own is not meaningful unless you have alternative results to compare against, either from the same recognition operation or from previous recognitions of the same input.
+
+ The values returned by <xref:System.Speech.Recognition.RecognizedWordUnit.Confidence%2A> are relative and unique to each recognition engine. There is no definition of how confidence values between two different recognition engines compare, nor how the <xref:System.Speech.Recognition.RecognizedWordUnit.Confidence%2A> of individual <xref:System.Speech.Recognition.RecognizedWordUnit> objects define the <xref:System.Speech.Recognition.RecognizedPhrase.Confidence%2A> of a <xref:System.Speech.Recognition.RecognizedPhrase>.
+
+ A speech recognition engine may assign a low confidence score to spoken input for various reasons, including background interference, inarticulate speech, or unanticipated words or word sequences. If your application is using a <xref:System.Speech.Recognition.SpeechRecognitionEngine> instance, you can modify the confidence level at which speech input is accepted or rejected with one of the <xref:System.Speech.Recognition.SpeechRecognitionEngine.UpdateRecognizerSetting%2A> methods. Confidence thresholds for the shared recognizer, managed by <xref:System.Speech.Recognition.SpeechRecognizer>, are associated with a user profile and stored in the Windows registry. Applications should not write changes to the registry for the properties of the shared recognizer.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -296,81 +296,81 @@ private void _emulateAndVerify_Click(object sender, EventArgs e)
         <summary>Gets formatting information used to create the text output from the current <see cref="T:System.Speech.Recognition.RecognizedWordUnit" /> instance.</summary>
         <value>Specifies the use of white space to display of the contents of a <see cref="T:System.Speech.Recognition.RecognizedWordUnit" /> object.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Speech.Recognition.DisplayAttributes> object returned by the <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property specifies the leading and trailing spaces to be used with a given word, if any.  
-  
- For more information about how to use this formatting information, see the <xref:System.Speech.Recognition.DisplayAttributes> enumeration.  
-  
-   
-  
-## Examples  
- The following example shows a utility routine (`stringFromWordArray`) that generates a string that is formatted in one of three ways: lexically (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), or phonetically (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from the <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property on a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on a <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
-```csharp  
-  
-internal enum WordType   
-{  
-  Text,  
-  Normalized = Text,  
-  Lexical,  
-  Pronunciation  
-}  
-```  
-  
-```csharp  
-internal static string stringFromWordArray(  
-        ReadOnlyCollection<RecognizedWordUnit> words,   
-        WordType type)   
-{  
-  string text = "";  
-  foreach (RecognizedWordUnit word in words)   
-  {  
-    string wordText = "";  
-    if (type == WordType.Text || type == WordType.Normalized)   
-    {  
-      wordText = word.Text;  
-    }   
-    else if (type == WordType.Lexical)   
-    {  
-      wordText = word.LexicalForm;  
-    }  
-    else if (type == WordType.Pronunciation)   
-    {  
-       wordText = word.Pronunciation;  
-    }   
-    else   
-    {  
-      throw new InvalidEnumArgumentException(  
-         String.Format("[0}: is not a valid input", type));  
-    }  
-  
-    // Use display attribute  
-    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)   
-    {  
-      wordText += " ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)  
-    {  
-      wordText += "  ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimStart();  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)  
-    {  
-      wordText = wordText.TrimEnd();  
-    }  
-  
-    text += wordText;  
-  
-  }  
-  return text;  
-}  
-```  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Speech.Recognition.DisplayAttributes> object returned by the <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property specifies the leading and trailing spaces to be used with a given word, if any.
+
+ For more information about how to use this formatting information, see the <xref:System.Speech.Recognition.DisplayAttributes> enumeration.
+
+
+
+## Examples
+ The following example shows a utility routine (`stringFromWordArray`) that generates a string that is formatted in one of three ways: lexically (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), or phonetically (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from the <xref:System.Speech.Recognition.RecognizedWordUnit.DisplayAttributes%2A> property on a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on a <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+```csharp
+
+internal enum WordType
+{
+  Text,
+  Normalized = Text,
+  Lexical,
+  Pronunciation
+}
+```
+
+```csharp
+internal static string stringFromWordArray(
+        ReadOnlyCollection<RecognizedWordUnit> words,
+        WordType type)
+{
+  string text = "";
+  foreach (RecognizedWordUnit word in words)
+  {
+    string wordText = "";
+    if (type == WordType.Text || type == WordType.Normalized)
+    {
+      wordText = word.Text;
+    }
+    else if (type == WordType.Lexical)
+    {
+      wordText = word.LexicalForm;
+    }
+    else if (type == WordType.Pronunciation)
+    {
+       wordText = word.Pronunciation;
+    }
+    else
+    {
+      throw new InvalidEnumArgumentException(
+         String.Format("[0}: is not a valid input", type));
+    }
+
+    // Use display attribute
+    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)
+    {
+      wordText += " ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)
+    {
+      wordText += "  ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)
+    {
+      wordText = wordText.TrimStart();
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)
+    {
+      wordText = wordText.TrimEnd();
+    }
+
+    text += wordText;
+
+  }
+  return text;
+}
+```
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Speech.Recognition.DisplayAttributes" />
@@ -403,81 +403,79 @@ internal static string stringFromWordArray(
         <summary>Gets the unnormalized text of a recognized word.</summary>
         <value>Returns a <see cref="T:System.String" /> containing the text of a recognized word, without any normalization.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- In most cases the values returned by <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A> and <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A> are identical. However, recognition engines may use speech normalization to return more user-friendly or colloquial text representations of audio input.  
-  
- Speech normalization is the use of special constructs or symbols to express speech in writing. For example, normalization can replace the spoken words "a dollar and sixteen cents" with "$1.16" in output text.  
-  
-   
-  
-## Examples  
- The following example shows a utility routine that generates text in one of three formats: lexical (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), and phonetic (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
-```csharp  
-  
-internal enum WordType   
-{  
-  Text,  
-  Normalized = Text,  
-  Lexical,  
-  Pronunciation  
-}  
-```  
-  
-```csharp  
-internal static string stringFromWordArray(  
-         ReadOnlyCollection<RecognizedWordUnit> words,   
-         WordType type)   
-{  
-  string text = "";  
-  foreach (RecognizedWordUnit word in words)   
-  {  
-    string wordText = "";  
-    if (type == WordType.Text || type == WordType.Normalized)   
-    {  
-      wordText = word.Text;  
-    }   
-    else if (type == WordType.Lexical)   
-    {  
-      wordText = word.LexicalForm;  
-    }   
-    else if (type == WordType.Pronunciation)   
-    {  
-      wordText = word.Pronunciation;  
-    }   
-    else   
-    {  
-      throw new InvalidEnumArgumentException(  
-          String.Format("[0}: is not a valid input", type));  
-    }  
-  
-    // Use display attribute  
-    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)   
-    {  
-      wordText += " ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)  
-    {  
-      wordText += "  ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimStart();  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)  
-    {  
-    wordText = wordText.TrimEnd();  
-    }  
-  
-    text += wordText;  
-  
-  }  
-  return text;  
-}  
-```  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ In most cases the values returned by <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A> and <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A> are identical. However, recognition engines may use speech normalization to return more user-friendly or colloquial text representations of audio input.
+
+ Speech normalization is the use of special constructs or symbols to express speech in writing. For example, normalization can replace the spoken words "a dollar and sixteen cents" with "$1.16" in output text.
+
+## Examples
+ The following example shows a utility routine that generates text in one of three formats: lexical (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), and phonetic (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+```csharp
+
+internal enum WordType
+{
+  Text,
+  Normalized = Text,
+  Lexical,
+  Pronunciation
+}
+```
+
+```csharp
+internal static string stringFromWordArray(
+         ReadOnlyCollection<RecognizedWordUnit> words,
+         WordType type)
+{
+  string text = "";
+  foreach (RecognizedWordUnit word in words)
+  {
+    string wordText = "";
+    if (type == WordType.Text || type == WordType.Normalized)
+    {
+      wordText = word.Text;
+    }
+    else if (type == WordType.Lexical)
+    {
+      wordText = word.LexicalForm;
+    }
+    else if (type == WordType.Pronunciation)
+    {
+      wordText = word.Pronunciation;
+    }
+    else
+    {
+      throw new InvalidEnumArgumentException(
+          String.Format("[0}: is not a valid input", type));
+    }
+
+    // Use display attribute
+    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)
+    {
+      wordText += " ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)
+    {
+      wordText += "  ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)
+    {
+      wordText = wordText.TrimStart();
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)
+    {
+    wordText = wordText.TrimEnd();
+    }
+
+    text += wordText;
+
+  }
+  return text;
+}
+```
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Speech.Recognition.DisplayAttributes" />
@@ -510,80 +508,80 @@ internal static string stringFromWordArray(
         <summary>Gets the phonetic spelling of a recognized word.</summary>
         <value>A string of characters from a supported phonetic alphabet, such as the International Phonetic Alphabet (IPA) or the Universal Phone Set (UPS).</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The contents of <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A> indicate which pronunciation the speech recognition engine used to match speech input to one of its loaded <xref:System.Speech.Recognition.Grammar> objects. Pronunciations may be defined in the speech recognition engine's internal lexicon, in a lexicon document that is linked from a recognition grammar in a loaded <xref:System.Speech.Recognition.Grammar> object, or inline in a recognition grammar in a loaded <xref:System.Speech.Recognition.Grammar> object. A speech recognition engine may also create pronunciations for uncommon words whose pronunciations are not defined in a lexicon or grammar to which the speech recognition engine currently has access.  
-  
- Many Windows-based Unicode fonts, such as Courier New, support the display of IPA strings. For more information, see [International Phonetic Alphabet](https://www.internationalphoneticassociation.org/content/ipa-chart).  
-  
-   
-  
-## Examples  
- The following example shows a utility routine that generates a string with one of three possible formats: lexical (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), and phonetic (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
-```csharp  
-  
-internal enum WordType   
-{  
-  Text,  
-  Normalized = Text,  
-  Lexical,  
-  Pronunciation  
-}  
-```  
-  
-```csharp  
-internal static string stringFromWordArray(  
-          ReadOnlyCollection<RecognizedWordUnit> words,   
-          WordType type)   
-{  
-  string text = "";  
-  foreach (RecognizedWordUnit word in words)   
-  {  
-    string wordText = "";  
-    if (type == WordType.Text || type == WordType.Normalized)   
-    {  
-      wordText = word.Text;  
-    }   
-    else if (type == WordType.Lexical)   
-    {  
-      wordText = word.LexicalForm;  
-    }   
-    else if (type == WordType.Pronunciation)   
-    {  
-      wordText = word.Pronunciation;  
-    }   
-    else   
-    {  
-      throw new InvalidEnumArgumentException(  
-          String.Format("[0}: is not a valid input", type));  
-    }  
-    // Use display attribute  
-  
-    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)   
-    {  
-      wordText += " ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)   
-    {  
-      wordText += "  ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimStart();  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimEnd();  
-    }  
-  
-    text += wordText;  
-  }  
-  return text;  
-}  
-```  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The contents of <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A> indicate which pronunciation the speech recognition engine used to match speech input to one of its loaded <xref:System.Speech.Recognition.Grammar> objects. Pronunciations may be defined in the speech recognition engine's internal lexicon, in a lexicon document that is linked from a recognition grammar in a loaded <xref:System.Speech.Recognition.Grammar> object, or inline in a recognition grammar in a loaded <xref:System.Speech.Recognition.Grammar> object. A speech recognition engine may also create pronunciations for uncommon words whose pronunciations are not defined in a lexicon or grammar to which the speech recognition engine currently has access.
+
+ Many Windows-based Unicode fonts, such as Courier New, support the display of IPA strings. For more information, see [International Phonetic Alphabet](https://www.internationalphoneticassociation.org/content/ipa-chart).
+
+
+
+## Examples
+ The following example shows a utility routine that generates a string with one of three possible formats: lexical (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), and phonetic (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+```csharp
+
+internal enum WordType
+{
+  Text,
+  Normalized = Text,
+  Lexical,
+  Pronunciation
+}
+```
+
+```csharp
+internal static string stringFromWordArray(
+          ReadOnlyCollection<RecognizedWordUnit> words,
+          WordType type)
+{
+  string text = "";
+  foreach (RecognizedWordUnit word in words)
+  {
+    string wordText = "";
+    if (type == WordType.Text || type == WordType.Normalized)
+    {
+      wordText = word.Text;
+    }
+    else if (type == WordType.Lexical)
+    {
+      wordText = word.LexicalForm;
+    }
+    else if (type == WordType.Pronunciation)
+    {
+      wordText = word.Pronunciation;
+    }
+    else
+    {
+      throw new InvalidEnumArgumentException(
+          String.Format("[0}: is not a valid input", type));
+    }
+    // Use display attribute
+
+    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)
+    {
+      wordText += " ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)
+    {
+      wordText += "  ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)
+    {
+      wordText = wordText.TrimStart();
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)
+    {
+      wordText = wordText.TrimEnd();
+    }
+
+    text += wordText;
+  }
+  return text;
+}
+```
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Speech.Recognition.DisplayAttributes" />
@@ -617,81 +615,79 @@ internal static string stringFromWordArray(
         <summary>Gets the normalized text for a recognized word.</summary>
         <value>A string that contains the normalized text output for a given input word.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- In most cases the values returned by <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A> and <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A> will be identical. However, recognition engines may use speech normalization to return more user-friendly or colloquial text representations of audio input.  
-  
- Speech normalization is the use of special constructs or symbols to express speech in writing. For example, normalization can replace the spoken words "a dollar and sixteen cents" with "$1.16" in output text.  
-  
-   
-  
-## Examples  
- The following example shows a utility routine that generates a string in one of three formats: lexical (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), and phonetic (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.  
-  
-```csharp  
-  
-internal enum WordType   
-{  
-  Text,  
-  Normalized = Text,  
-  Lexical,  
-  Pronunciation  
-}  
-```  
-  
-```csharp  
-internal static string stringFromWordArray(  
-          ReadOnlyCollection<RecognizedWordUnit> words,   
-          WordType type)   
-{  
-  string text = "";  
-  foreach (RecognizedWordUnit word in words)   
-  {  
-    string wordText = "";  
-    if (type == WordType.Text || type == WordType.Normalized)   
-    {  
-      wordText = word.Text;  
-    }   
-    else if (type == WordType.Lexical)   
-    {  
-      wordText = word.LexicalForm;  
-    }   
-    else if (type == WordType.Pronunciation)   
-    {  
-      wordText = word.Pronunciation;  
-    }   
-    else   
-    {  
-      throw new InvalidEnumArgumentException(  
-           String.Format("[0}: is not a valid input", type));  
-    }  
-  
-    // Use display attribute  
-    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)   
-    {  
-      wordText += " ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)   
-    {  
-      wordText += "  ";  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimStart();  
-    }  
-    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)   
-    {  
-      wordText = wordText.TrimEnd();  
-    }  
-  
-    text += wordText;  
-  
-  }  
-  return text;  
-}  
-```  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ In most cases the values returned by <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A> and <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A> will be identical. However, recognition engines may use speech normalization to return more user-friendly or colloquial text representations of audio input.
+
+ Speech normalization is the use of special constructs or symbols to express speech in writing. For example, normalization can replace the spoken words "a dollar and sixteen cents" with "$1.16" in output text.
+
+## Examples
+ The following example shows a utility routine that generates a string in one of three formats: lexical (using <xref:System.Speech.Recognition.RecognizedWordUnit.LexicalForm%2A>), normalized (using <xref:System.Speech.Recognition.RecognizedWordUnit.Text%2A>), and phonetic (using <xref:System.Speech.Recognition.RecognizedWordUnit.Pronunciation%2A>). The text output is obtained from a <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> of <xref:System.Speech.Recognition.RecognizedWordUnit> objects, which is obtained from the <xref:System.Speech.Recognition.RecognizedPhrase.Words%2A> property on the <xref:System.Speech.Recognition.RecognizedPhrase> object.
+
+```csharp
+
+internal enum WordType
+{
+  Text,
+  Normalized = Text,
+  Lexical,
+  Pronunciation
+}
+```
+
+```csharp
+internal static string stringFromWordArray(
+          ReadOnlyCollection<RecognizedWordUnit> words,
+          WordType type)
+{
+  string text = "";
+  foreach (RecognizedWordUnit word in words)
+  {
+    string wordText = "";
+    if (type == WordType.Text || type == WordType.Normalized)
+    {
+      wordText = word.Text;
+    }
+    else if (type == WordType.Lexical)
+    {
+      wordText = word.LexicalForm;
+    }
+    else if (type == WordType.Pronunciation)
+    {
+      wordText = word.Pronunciation;
+    }
+    else
+    {
+      throw new InvalidEnumArgumentException(
+           String.Format("[0}: is not a valid input", type));
+    }
+
+    // Use display attribute
+    if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)
+    {
+      wordText += " ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)
+    {
+      wordText += "  ";
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)
+    {
+      wordText = wordText.TrimStart();
+    }
+    if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)
+    {
+      wordText = wordText.TrimEnd();
+    }
+
+    text += wordText;
+
+  }
+  return text;
+}
+```
+
  ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonPolymorphismOptions.xml b/xml/System.Text.Json.Serialization.Metadata/JsonPolymorphismOptions.xml
index 0413a6bea9d..facd6007299 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonPolymorphismOptions.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonPolymorphismOptions.xml
@@ -111,7 +111,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets a custom type discriminator property name for the polymorhic type.
+        <summary>Gets or sets a custom type discriminator property name for the polymorphic type.
             Uses the default '$type' property name if left unset.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Text.Json.Serialization/ReferenceResolver.xml b/xml/System.Text.Json.Serialization/ReferenceResolver.xml
index b0d823b32ab..1da13554605 100644
--- a/xml/System.Text.Json.Serialization/ReferenceResolver.xml
+++ b/xml/System.Text.Json.Serialization/ReferenceResolver.xml
@@ -76,7 +76,7 @@
       <Docs>
         <param name="referenceId">The identifier of the JSON object or array.</param>
         <param name="value">The value of the CLR reference type object that results from parsing the JSON object.</param>
-        <summary>Adds an entry to the bag of references using the specified id and value.
+        <summary>Adds an entry to the bag of references using the specified ID and value.
  This method gets called when an $id metadata property from a JSON object is read.</summary>
         <remarks>To be added.</remarks>
       </Docs>
@@ -105,11 +105,11 @@
         <Parameter Name="alreadyExists" Type="System.Boolean" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="value">The value of the CLR reference type object to get an id for.</param>
+        <param name="value">The value of the CLR reference type object to get an ID for.</param>
         <param name="alreadyExists">When this method returns, <see langword="true" /> if a reference to value already exists; otherwise, <see langword="false" />.</param>
-        <summary>Gets the reference identifier of the specified value if exists; otherwise a new id is assigned.
- This method gets called before a CLR object is written so we can decide whether to write $id and enumerate the rest of its properties or $ref and step into the next object.</summary>
-        <returns>The reference id for the specified object.</returns>
+        <summary>Gets the reference identifier of the specified value if exists; otherwise a new ID is assigned.
+ This method gets called before a CLR object is written so we can decide whether to write \\$id and enumerate the rest of its properties or \\$ref and step into the next object.</summary>
+        <returns>The reference ID for the specified object.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -136,10 +136,10 @@
         <Parameter Name="referenceId" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="referenceId">The reference id related to the returned object.</param>
-        <summary>Returns the CLR reference type object related to the specified reference id.
- This method gets called when $ref metadata property is read.</summary>
-        <returns>The reference type object related to the specified reference id.</returns>
+        <param name="referenceId">The reference ID related to the returned object.</param>
+        <summary>Returns the CLR reference type object related to the specified reference ID.
+ This method is called when $ref metadata property is read.</summary>
+        <returns>The reference type object related to the specified reference ID.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml
index 8a883d3a467..655e5ac2bf3 100644
--- a/xml/System.Text.Json/JsonSerializerOptions.xml
+++ b/xml/System.Text.Json/JsonSerializerOptions.xml
@@ -189,13 +189,9 @@ similar to how <xref:System.Text.Json.Serialization.Metadata.JsonTypeInfoResolve
       <Docs>
         <summary>Allows JSON metadata properties to be specified after regular properties in a deserialized JSON object.</summary>
         <value>To be added.</value>
-        <remarks>
-          <para>When set to <see langword="true" />, removes the requirement that JSON metadata properties</para>
-          <para>such as $id and $type should be specified at the very start of the deserialized JSON object.</para>
-          <para>It should be noted that enabling this setting can result in over-buffering</para>
-          <para>when deserializing large JSON payloads in the context of streaming deserialization.</para>
+        <remarks>When set to <see langword="true" />, removes the requirement that JSON metadata properties, such as \\$id and \\$type, be specified at the very start of the deserialized JSON object. If you enable this setting, it can result in over-buffering when deserializing large JSON payloads in the context of streaming deserialization.
         </remarks>
-        <exception cref="T:System.InvalidOperationException">Thrown if this property is set after serialization or deserialization has occurred.</exception>
+        <exception cref="T:System.InvalidOperationException">This property is set after serialization or deserialization has occurred.</exception>
       </Docs>
     </Member>
     <Member MemberName="AllowTrailingCommas">
diff --git a/xml/System.Text/UTF7Encoding.xml b/xml/System.Text/UTF7Encoding.xml
index beabc66e056..c43a0f95ffc 100644
--- a/xml/System.Text/UTF7Encoding.xml
+++ b/xml/System.Text/UTF7Encoding.xml
@@ -58,36 +58,36 @@
   <Docs>
     <summary>Represents a UTF-7 encoding of Unicode characters.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Encoding is the process of transforming a set of Unicode characters into a sequence of bytes. Decoding is the process of transforming a sequence of encoded bytes into a set of Unicode characters.  
-  
- The UTF-7 encoding represents Unicode characters as sequences of 7-bit ASCII characters. This encoding supports certain protocols for which it is required, most often email or newsgroup protocols. Since UTF-7 is not particularly secure or robust, and most modern systems allow 8-bit encodings, UTF-8 should normally be preferred to UTF-7.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Encoding is the process of transforming a set of Unicode characters into a sequence of bytes. Decoding is the process of transforming a sequence of encoded bytes into a set of Unicode characters.
+
+ The UTF-7 encoding represents Unicode characters as sequences of 7-bit ASCII characters. This encoding supports certain protocols for which it is required, most often email or newsgroup protocols. Since UTF-7 is not particularly secure or robust, and most modern systems allow 8-bit encodings, UTF-8 should normally be preferred to UTF-7.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. For security reasons, the application should use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
- For more information about the UTFs and other encodings supported by <xref:System.Text>, see [Character Encoding in the .NET Framework](/dotnet/standard/base-types/character-encoding).  
-  
- The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method determines how many bytes result in encoding a set of Unicode characters, and the <xref:System.Text.UTF7Encoding.GetBytes%2A> method performs the actual encoding.  
-  
- Likewise, the <xref:System.Text.UTF7Encoding.GetCharCount%2A> method determines how many characters result in decoding a sequence of bytes, and the <xref:System.Text.UTF7Encoding.GetChars%2A> and <xref:System.Text.UTF7Encoding.GetString%2A> methods perform the actual decoding.  
-  
- <xref:System.Text.UTF7Encoding> corresponds to the Windows code page 65000.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. For security reasons, the application should use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+ For more information about the UTFs and other encodings supported by <xref:System.Text>, see [Character Encoding in the .NET Framework](/dotnet/standard/base-types/character-encoding).
+
+ The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method determines how many bytes result in encoding a set of Unicode characters, and the <xref:System.Text.UTF7Encoding.GetBytes%2A> method performs the actual encoding.
+
+ Likewise, the <xref:System.Text.UTF7Encoding.GetCharCount%2A> method determines how many characters result in decoding a sequence of bytes, and the <xref:System.Text.UTF7Encoding.GetChars%2A> and <xref:System.Text.UTF7Encoding.GetString%2A> methods perform the actual decoding.
+
+ <xref:System.Text.UTF7Encoding> corresponds to the Windows code page 65000.
+
 > [!NOTE]
->  The state of a UTF-7 encoded object is not preserved if the object is serialized and deserialized using different .NET Framework versions.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use a <xref:System.Text.UTF7Encoding> to encode a string of Unicode characters and store them in a byte array. Notice that when the byte array is decoded back to a string, no data is lost.  
-  
+>  The state of a UTF-7 encoded object is not preserved if the object is serialized and deserialized using different .NET Framework versions.
+
+
+
+## Examples
+ The following code example demonstrates how to use a <xref:System.Text.UTF7Encoding> to encode a string of Unicode characters and store them in a byte array. Notice that when the byte array is decoded back to a string, no data is lost.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding Example/CPP/snippet.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/Overview/snippet.cs" interactive="try-dotnet" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding Example/VB/snippet.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding Example/VB/snippet.vb" id="Snippet1":::
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.Text.Decoder" />
@@ -146,25 +146,25 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This constructor creates an instance that does not allow optional characters. Calling the <xref:System.Text.UTF7Encoding.%23ctor%2A> constructor is equivalent to calling the <xref:System.Text.UTF7Encoding.%23ctor%28System.Boolean%29?displayProperty=nameWithType> constructor that takes an `allowOptionals` parameter and specifying `false` for that parameter.  
-  
- If an instance allows optional characters, Unicode code points are encoded with a corresponding optional character instead of a modified base 64 character. The optional characters are exclamation point ("!"), backward slash ("\\"), vertical line ("&#124;"), double quote ("""), number sign ("#"), dollar sign ("$"), percent sign ("%"), ampersand ("&"), asterisk ("*"), semicolon (";"), left angle bracket ("\<"), right angle bracket (">"), left curly bracket ("{"), right curly bracket ("}"), left square bracket ("["), right square bracket ("]"), equal sign ("="), at sign ("@"), circumflex accent ("^"), underscore ("_"), and grave accent ("`").  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This constructor creates an instance that does not allow optional characters. Calling the <xref:System.Text.UTF7Encoding.%23ctor%2A> constructor is equivalent to calling the <xref:System.Text.UTF7Encoding.%23ctor%28System.Boolean%29?displayProperty=nameWithType> constructor that takes an `allowOptionals` parameter and specifying `false` for that parameter.
+
+ If an instance allows optional characters, Unicode code points are encoded with a corresponding optional character instead of a modified base 64 character. The optional characters are exclamation point ("!"), backward slash ("\\"), vertical line ("&#124;"), double quote ("""), number sign ("#"), dollar sign ("$"), percent sign ("%"), ampersand ("&"), asterisk ("*"), semicolon (";"), left angle bracket ("\<"), right angle bracket (">"), left curly bracket ("{"), right curly bracket ("}"), left square bracket ("["), right square bracket ("]"), equal sign ("="), at sign ("@"), circumflex accent ("^"), underscore ("_"), and grave accent ("`").
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to create a new <xref:System.Text.UTF7Encoding> instance and display the name of the encoding.  
-  
+> <xref:System.Text.UTF7Encoding> does not provide error detection. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+
+
+## Examples
+ The following code example demonstrates how to create a new <xref:System.Text.UTF7Encoding> instance and display the name of the encoding.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.ctor1 Example/CPP/ctor.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/.ctor/ctor.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.ctor1 Example/VB/ctor.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.ctor1 Example/VB/ctor.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -215,23 +215,23 @@
           <see langword="true" /> to specify that optional characters are allowed; otherwise, <see langword="false" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding" /> class. A parameter specifies whether to allow optional characters.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If an instance allows optional characters, Unicode code points are encoded with a corresponding optional character instead of a modified base 64 character. The optional characters are exclamation point ("!"), backward slash ("\\"), vertical line ("&#124;"), double quote ("""), number sign ("#"), dollar sign ("$"), percent sign ("%"), ampersand ("&"), asterisk ("*"), semicolon (";"), left angle bracket ("\<"), right angle bracket (">"), left curly bracket ("{"), right curly bracket ("}"), left square bracket ("["), right square bracket ("]"), equal sign ("="), at sign ("@"), circumflex accent ("^"), underscore ("_"), and grave accent ("`").  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ If an instance allows optional characters, Unicode code points are encoded with a corresponding optional character instead of a modified base 64 character. The optional characters are exclamation point ("!"), backward slash ("\\"), vertical line ("&#124;"), double quote ("""), number sign ("#"), dollar sign ("$"), percent sign ("%"), ampersand ("&"), asterisk ("*"), semicolon (";"), left angle bracket ("\<"), right angle bracket (">"), left curly bracket ("{"), right curly bracket ("}"), left square bracket ("["), right square bracket ("]"), equal sign ("="), at sign ("@"), circumflex accent ("^"), underscore ("_"), and grave accent ("`").
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to create a new <xref:System.Text.UTF7Encoding> instance that allows optional characters.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+
+
+## Examples
+ The following code example demonstrates how to create a new <xref:System.Text.UTF7Encoding> instance that allows optional characters.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.ctor2 Example/CPP/ctor-boolean.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/.ctor/ctor-boolean.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.ctor2 Example/VB/ctor-boolean.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.ctor2 Example/VB/ctor-boolean.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -293,11 +293,11 @@
         <returns>
           <see langword="true" /> if <paramref name="value" /> is a <see cref="T:System.Text.UTF7Encoding" /> object and is equal to the current <see cref="T:System.Text.UTF7Encoding" /> object; otherwise, <see langword="false" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Two <xref:System.Text.UTF7Encoding> objects are equal if they both either allow or disallow optional characters, and if their underlying <xref:System.Text.Encoding.EncoderFallback%2A> and <xref:System.Text.Encoding.DecoderFallback%2A> properties are equal.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Two <xref:System.Text.UTF7Encoding> objects are equal if they both either allow or disallow optional characters, and if their underlying <xref:System.Text.Encoding.EncoderFallback%2A> and <xref:System.Text.Encoding.DecoderFallback%2A> properties are equal.
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Text.Encoding" />
@@ -366,29 +366,29 @@
         <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" /> object.</summary>
         <returns>The number of bytes produced by encoding the specified characters.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size that <xref:System.Text.UTF7Encoding.GetBytes%2A> requires to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetByteCount%2A> method to return the number of bytes required to encode a character array.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size that <xref:System.Text.UTF7Encoding.GetBytes%2A> requires to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetByteCount%2A> method to return the number of bytes required to encode a character array.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetByteCount Example/CPP/getbytecount-char[]-int32-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetByteCount/getbytecount-char[]-int32-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetByteCount Example/VB/getbytecount-char[]-int32-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetByteCount Example/VB/getbytecount-char[]-int32-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>).
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" />
@@ -452,25 +452,25 @@
         <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
         <returns>The number of bytes produced by encoding the specified characters.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size that <xref:System.Text.UTF7Encoding.GetBytes%2A> requires to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size that <xref:System.Text.UTF7Encoding.GetBytes%2A> requires to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" /> in Visual Basic .NET).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="count" /> is less than zero.  
-  
- -or-  
-  
+          <paramref name="count" /> is less than zero.
+
+ -or-
+
  The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" />
@@ -530,38 +530,38 @@
         <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
         <returns>The number of bytes produced by encoding the specified characters.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetByteCount%2A> method to return the number of bytes required to encode an array of Unicode characters.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetByteCount%2A> method to return the number of bytes required to encode an array of Unicode characters.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetByteCount Example/CPP/getbytecount-char[]-int32-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetByteCount/getbytecount-char[]-int32-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetByteCount Example/VB/getbytecount-char[]-int32-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetByteCount Example/VB/getbytecount-char[]-int32-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="index" /> or <paramref name="count" /> is less than zero.  
-  
- -or-  
-  
- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.  
-  
- -or-  
-  
+          <paramref name="index" /> or <paramref name="count" /> is less than zero.
+
+ -or-
+
+ <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
+
+ -or-
+
  The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" />
@@ -639,32 +639,32 @@
         <summary>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</summary>
         <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
- Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
+ Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. Invalid characters are encoded as a modified base 64 character. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. Invalid characters are encoded as a modified base 64 character. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).  
-  
- -or-  
-  
+          <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
+
+ -or-
+
  <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see> for fuller explanation).
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetEncoder" />
         <altmember cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />
@@ -728,49 +728,49 @@
         <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
         <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
- Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
+ Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. Invalid characters are encoded as a modified base 64 character. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetBytes%2A> method to encode a range of characters from a <xref:System.String> and store the encoded bytes in a range of elements in a byte array.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. Invalid characters are encoded as a modified base 64 character. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetBytes%2A> method to encode a range of characters from a <xref:System.String> and store the encoded bytes in a range of elements in a byte array.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetBytes Example/CPP/getbytes-char[]-int32-int32-byte[]-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetBytes/getbytes-char[]-int32-int32-byte[]-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetBytes Example/VB/getbytes-char[]-int32-int32-byte[]-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetBytes Example/VB/getbytes-char[]-int32-int32-byte[]-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).  
-  
- -or-  
-  
+          <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
+
+ -or-
+
  <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.  
-  
- -or-  
-  
- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.  
-  
- -or-  
-  
+          <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
+
+ -or-
+
+ <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
+
+ -or-
+
  <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see> for fuller explanation).
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetEncoder" />
         <altmember cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />
@@ -837,49 +837,49 @@
         <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
         <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
- Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
+ Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. Invalid characters are encoded as a modified base 64 character. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetBytes%2A> method to encode a range of elements from a Unicode character array, and store the encoded bytes in a range of elements in a byte array.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. Invalid characters are encoded as a modified base 64 character. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetBytes%2A> method to encode a range of elements from a Unicode character array, and store the encoded bytes in a range of elements in a byte array.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetBytes Example/CPP/getbytes-char[]-int32-int32-byte[]-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetBytes/getbytes-char[]-int32-int32-byte[]-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetBytes Example/VB/getbytes-char[]-int32-int32-byte[]-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetBytes Example/VB/getbytes-char[]-int32-int32-byte[]-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).  
-  
- -or-  
-  
+          <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).
+
+ -or-
+
  <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.  
-  
- -or-  
-  
- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.  
-  
- -or-  
-  
+          <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
+
+ -or-
+
+ <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
+
+ -or-
+
  <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see> for fuller explanation).
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetEncoder" />
         <altmember cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />
@@ -953,25 +953,25 @@
         <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
         <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="count" /> is less than zero.  
-  
- -or-  
-  
+          <paramref name="count" /> is less than zero.
+
+ -or-
+
  The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>).
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
         <altmember cref="Overload:System.Text.UTF7Encoding.GetChars" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />
@@ -1031,38 +1031,38 @@
         <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
         <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetCharCount%2A> method to return the number of characters produced by decoding a range of elements in a byte array.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetCharCount%2A> method to return the number of characters produced by decoding a range of elements in a byte array.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UnicodeEncoding.GetCharCount Example/CPP/getcharcount-byte[]-int32-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UnicodeEncoding/GetCharCount/getcharcount-byte[]-int32-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UnicodeEncoding.GetCharCount Example/VB/getcharcount-byte[]-int32-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UnicodeEncoding.GetCharCount Example/VB/getcharcount-byte[]-int32-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="index" /> or <paramref name="count" /> is less than zero.  
-  
- -or-  
-  
- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.  
-  
- -or-  
-  
+          <paramref name="index" /> or <paramref name="count" /> is less than zero.
+
+ -or-
+
+ <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
+
+ -or-
+
  The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
         <altmember cref="Overload:System.Text.UTF7Encoding.GetChars" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />
@@ -1140,32 +1140,32 @@
         <summary>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</summary>
         <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.  
-  
- Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.
+
+ Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. When invalid bytes are encountered, <xref:System.Text.UTF7Encoding> generally emits the invalid bytes. If a byte is larger than hexadecimal 0x7F, the byte value is zero-extended into a Unicode character, the result is stored in the `chars` array, and any shift sequence is terminated. For example, if the byte to encode is hexadecimal 0x81, the resulting character is U+0081. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. When invalid bytes are encountered, <xref:System.Text.UTF7Encoding> generally emits the invalid bytes. If a byte is larger than hexadecimal 0x7F, the byte value is zero-extended into a Unicode character, the result is stored in the `chars` array, and any shift sequence is terminated. For example, if the byte to encode is hexadecimal 0x81, the resulting character is U+0081. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).  
-  
- -or-  
-  
+          <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
+
+ -or-
+
  <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="charCount" /> is less than the resulting number of characters.</exception>
         <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />
@@ -1230,49 +1230,49 @@
         <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
         <returns>The actual number of characters written into <paramref name="chars" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.  
-  
- Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, use <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.
+
+ Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. When invalid bytes are encountered, <xref:System.Text.UTF7Encoding> generally emits the invalid bytes. If a byte is larger than hexadecimal 0x7F, the byte value is zero-extended into a Unicode character, the result is stored in the `chars` array, and any shift sequence is terminated. For example, if the byte to encode is hexadecimal 0x81, the resulting character is U+0081. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetChars%2A> method to decode a range of elements in a byte array and store the result in a character array.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. When invalid bytes are encountered, <xref:System.Text.UTF7Encoding> generally emits the invalid bytes. If a byte is larger than hexadecimal 0x7F, the byte value is zero-extended into a Unicode character, the result is stored in the `chars` array, and any shift sequence is terminated. For example, if the byte to encode is hexadecimal 0x81, the resulting character is U+0081. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetChars%2A> method to decode a range of elements in a byte array and store the result in a character array.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetChars Example/CPP/getchars-byte[]-int32-int32-char[]-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetChars/getchars-byte[]-int32-int32-char[]-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetChars Example/VB/getchars-byte[]-int32-int32-char[]-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetChars Example/VB/getchars-byte[]-int32-int32-char[]-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
-          <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).  
-  
- -or-  
-  
+          <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
+
+ -or-
+
  <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.  
-  
- -or-  
-  
- <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.  
-  
- -or-  
-  
+          <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
+
+ -or-
+
+ <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
+
+ -or-
+
  <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
         <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />
@@ -1320,20 +1320,20 @@
         <summary>Obtains a decoder that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</summary>
         <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Text.Decoder.GetChars%2A?displayProperty=nameWithType> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <xref:System.Text.UTF7Encoding.GetChars%2A> method of this class. However, a <xref:System.Text.Decoder> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <xref:System.Text.Decoder> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <xref:System.Text.UTF7Encoding.GetDecoder%2A> and <xref:System.Text.UTF7Encoding.GetEncoder%2A> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method to obtain a decoder to convert the UTF-7 encoded bytes into a sequence of characters.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Text.Decoder.GetChars%2A?displayProperty=nameWithType> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <xref:System.Text.UTF7Encoding.GetChars%2A> method of this class. However, a <xref:System.Text.Decoder> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <xref:System.Text.Decoder> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <xref:System.Text.UTF7Encoding.GetDecoder%2A> and <xref:System.Text.UTF7Encoding.GetEncoder%2A> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method to obtain a decoder to convert the UTF-7 encoded bytes into a sequence of characters.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetDecoder Example/CPP/getdecoder-.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetDecoder/getdecoder-.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetDecoder Example/VB/getdecoder-.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetDecoder Example/VB/getdecoder-.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Text.Decoder" />
@@ -1384,20 +1384,20 @@
         <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</summary>
         <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Text.Decoder.GetChars%2A?displayProperty=nameWithType> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <xref:System.Text.UTF7Encoding.GetChars%2A> method. However, a <xref:System.Text.Decoder> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <xref:System.Text.Decoder> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <xref:System.Text.UTF7Encoding.GetDecoder%2A> and <xref:System.Text.UTF7Encoding.GetEncoder%2A> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method to obtain an encoder to convert a sequence of characters into a UTF-7 encoded sequence of bytes.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Text.Decoder.GetChars%2A?displayProperty=nameWithType> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <xref:System.Text.UTF7Encoding.GetChars%2A> method. However, a <xref:System.Text.Decoder> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <xref:System.Text.Decoder> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <xref:System.Text.UTF7Encoding.GetDecoder%2A> and <xref:System.Text.UTF7Encoding.GetEncoder%2A> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method to obtain an encoder to convert a sequence of characters into a UTF-7 encoded sequence of bytes.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetEncoder Example/CPP/getencoder-.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetEncoder/getencoder-.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetEncoder Example/VB/getencoder-.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetEncoder Example/VB/getencoder-.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Text.Encoder" />
@@ -1452,11 +1452,11 @@
         <summary>Returns the hash code for the current <see cref="T:System.Text.UTF7Encoding" /> object.</summary>
         <returns>A 32-bit signed integer hash code.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The value returned by the <xref:System.Text.UTF7Encoding.GetHashCode%2A> method is not suitable for distinguishing one <xref:System.Text.UTF7Encoding> object from another. If your application needs a unique hash code, it should override the <xref:System.Text.UTF7Encoding.GetHashCode%2A> method.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The value returned by the <xref:System.Text.UTF7Encoding.GetHashCode%2A> method is not suitable for distinguishing one <xref:System.Text.UTF7Encoding> object from another. If your application needs a unique hash code, it should override the <xref:System.Text.UTF7Encoding.GetHashCode%2A> method.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -1504,41 +1504,41 @@
         <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
         <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.  
-  
- <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> is a worst-case number, including the worst case for the currently selected <xref:System.Text.EncoderFallback>. If a fallback is chosen with a potentially large string, <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> can return large values.  
-  
- In most cases, this method returns reasonable numbers for small strings. For large strings, you might have to choose between using very large buffers and catching errors in the rare case that a more reasonable buffer is exceeded. You might also want to consider a different approach using <xref:System.Text.UTF7Encoding.GetByteCount%2A> or <xref:System.Text.Encoder.Convert%2A?displayProperty=nameWithType>. While UTF-7 is very efficient at encoding ASCII data, one byte per character, it is extremely inefficient for other data. As remarked above, <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> deals with a worst case. If the data to be encoded is largely ASCII, and especially if the ASCII characters cluster together, UTF-7 is significantly more efficient than the number returned by this method suggests.  
-  
- <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> has no relation to <xref:System.Text.UTF7Encoding.GetChars%2A>. If your application needs a similar function to use with <xref:System.Text.UTF7Encoding.GetChars%2A>, it should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetBytes%2A> to store the resulting bytes, the application uses <xref:System.Text.UTF7Encoding.GetByteCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>. The <xref:System.Text.UTF7Encoding.GetByteCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method generally executes faster.
+
+ <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> is a worst-case number, including the worst case for the currently selected <xref:System.Text.EncoderFallback>. If a fallback is chosen with a potentially large string, <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> can return large values.
+
+ In most cases, this method returns reasonable numbers for small strings. For large strings, you might have to choose between using very large buffers and catching errors in the rare case that a more reasonable buffer is exceeded. You might also want to consider a different approach using <xref:System.Text.UTF7Encoding.GetByteCount%2A> or <xref:System.Text.Encoder.Convert%2A?displayProperty=nameWithType>. While UTF-7 is very efficient at encoding ASCII data, one byte per character, it is extremely inefficient for other data. As remarked above, <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> deals with a worst case. If the data to be encoded is largely ASCII, and especially if the ASCII characters cluster together, UTF-7 is significantly more efficient than the number returned by this method suggests.
+
+ <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> has no relation to <xref:System.Text.UTF7Encoding.GetChars%2A>. If your application needs a similar function to use with <xref:System.Text.UTF7Encoding.GetChars%2A>, it should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>.
+
 > [!NOTE]
->  `GetMaxByteCount(N)` is not necessarily the same value as `N* GetMaxByteCount(1)`.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method to return the maximum number of bytes required to encode a specified number of characters.  
-  
+>  `GetMaxByteCount(N)` is not necessarily the same value as `N* GetMaxByteCount(1)`.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A> method to return the maximum number of bytes required to encode a specified number of characters.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetMaxByteCount Example/CPP/getmaxbytecount-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetMaxByteCount/getmaxbytecount-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetMaxByteCount Example/VB/getmaxbytecount-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetMaxByteCount Example/VB/getmaxbytecount-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="charCount" /> is less than zero.  
-  
- -or-  
-  
+          <paramref name="charCount" /> is less than zero.
+
+ -or-
+
  The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />
@@ -1588,41 +1588,41 @@
         <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
         <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, the application uses <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.  
-  
- <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> is a worst-case number, including the worst case for the currently selected <xref:System.Text.DecoderFallback>. If a fallback is chosen with a potentially large string, <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> can return large values.  
-  
- In most cases, this method returns reasonable numbers for small strings. For large strings, you might have to choose between using very large buffers and catching errors in the rare case that a more reasonable buffer is exceeded. You might also want to consider a different approach using <xref:System.Text.UTF7Encoding.GetCharCount%2A> or <xref:System.Text.Decoder.Convert%2A?displayProperty=nameWithType>.  
-  
- <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> has no relation to <xref:System.Text.UTF7Encoding.GetBytes%2A>. If your application needs a similar function to use with <xref:System.Text.UTF7Encoding.GetBytes%2A>, it should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ To calculate the exact array size required by <xref:System.Text.UTF7Encoding.GetChars%2A> to store the resulting characters, the application uses <xref:System.Text.UTF7Encoding.GetCharCount%2A>. To calculate the maximum array size, the application should use <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A>. The <xref:System.Text.UTF7Encoding.GetCharCount%2A> method generally allows allocation of less memory, while the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method generally executes faster.
+
+ <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> is a worst-case number, including the worst case for the currently selected <xref:System.Text.DecoderFallback>. If a fallback is chosen with a potentially large string, <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> can return large values.
+
+ In most cases, this method returns reasonable numbers for small strings. For large strings, you might have to choose between using very large buffers and catching errors in the rare case that a more reasonable buffer is exceeded. You might also want to consider a different approach using <xref:System.Text.UTF7Encoding.GetCharCount%2A> or <xref:System.Text.Decoder.Convert%2A?displayProperty=nameWithType>.
+
+ <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> has no relation to <xref:System.Text.UTF7Encoding.GetBytes%2A>. If your application needs a similar function to use with <xref:System.Text.UTF7Encoding.GetBytes%2A>, it should use <xref:System.Text.UTF7Encoding.GetMaxByteCount%2A>.
+
 > [!NOTE]
->  `GetMaxCharCount(N)` is not necessarily the same value as `N* GetMaxCharCount(1)`.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method to return the maximum number of characters produced by decoding a specified number of bytes.  
-  
+>  `GetMaxCharCount(N)` is not necessarily the same value as `N* GetMaxCharCount(1)`.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Text.UTF7Encoding.GetMaxCharCount%2A> method to return the maximum number of characters produced by decoding a specified number of bytes.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetMaxCharCount Example/CPP/getmaxcharcount-int32.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetMaxCharCount/getmaxcharcount-int32.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetMaxCharCount Example/VB/getmaxcharcount-int32.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.GetMaxCharCount Example/VB/getmaxcharcount-int32.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="byteCount" /> is less than zero.  
-  
- -or-  
-  
+          <paramref name="byteCount" /> is less than zero.
+
+ -or-
+
  The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
         <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>)
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)" />
@@ -1686,37 +1686,37 @@
         <summary>Decodes a range of bytes from a byte array into a string.</summary>
         <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Data to be converted, such as data read from a stream, might be available only in sequential blocks. In this case, or if the amount of data is so large that it needs to be divided into smaller blocks, the application should use the <xref:System.Text.Decoder> or the <xref:System.Text.Encoder> provided by the <xref:System.Text.UTF7Encoding.GetDecoder%2A> method or the <xref:System.Text.UTF7Encoding.GetEncoder%2A> method, respectively.
+
 > [!NOTE]
->  <xref:System.Text.UTF7Encoding> does not provide error detection. When invalid bytes are encountered, <xref:System.Text.UTF7Encoding> generally emits the invalid bytes. If a byte is larger than hexadecimal 0x7F, the byte value is zero-extended into a Unicode character, the result is stored in the `chars` array, and any shift sequence is terminated. For example, if the byte to encode is hexadecimal 0x81, the resulting character is U+0081. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.  
-  
-   
-  
-## Examples  
- The following code example encodes a string into an array of bytes, and then decodes the bytes back into a string.  
-  
+>  <xref:System.Text.UTF7Encoding> does not provide error detection. When invalid bytes are encountered, <xref:System.Text.UTF7Encoding> generally emits the invalid bytes. If a byte is larger than hexadecimal 0x7F, the byte value is zero-extended into a Unicode character, the result is stored in the `chars` array, and any shift sequence is terminated. For example, if the byte to encode is hexadecimal 0x81, the resulting character is U+0081. For security reasons, your applications are recommended to use <xref:System.Text.UTF8Encoding>, <xref:System.Text.UnicodeEncoding>, or <xref:System.Text.UTF32Encoding> and enable error detection.
+
+
+
+## Examples
+ The following code example encodes a string into an array of bytes, and then decodes the bytes back into a string.
+
  :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Text.UTF7Encoding.getstring/CPP/getstring.cpp" id="Snippet1":::
  :::code language="csharp" source="~/snippets/csharp/System.Text/UTF7Encoding/GetString/getstring.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.getstring/VB/getstring.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.Text.UTF7Encoding.getstring/VB/getstring.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="index" /> or <paramref name="count" /> is less than zero.  
-  
- -or-  
-  
+          <paramref name="index" /> or <paramref name="count" /> is less than zero.
+
+ -or-
+
  <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
         <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see <see href="https://learn.microsoft.com/dotnet/standard/base-types/character-encoding">Character Encoding in .NET</see>).
-  
- -and-  
-  
+
+ -and-
+
  <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
         <altmember cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" />
         <altmember cref="M:System.Text.UTF7Encoding.GetDecoder" />
diff --git a/xml/System.Web.UI.WebControls/BoundField.xml b/xml/System.Web.UI.WebControls/BoundField.xml
index 4d1abf82294..bfd70f6a7a9 100644
--- a/xml/System.Web.UI.WebControls/BoundField.xml
+++ b/xml/System.Web.UI.WebControls/BoundField.xml
@@ -17,37 +17,37 @@
   <Docs>
     <summary>Represents a field that is displayed as text in a data-bound control.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField> class is used by data-bound controls (such as <xref:System.Web.UI.WebControls.GridView> and <xref:System.Web.UI.WebControls.DetailsView>) to display the value of a field as text. The <xref:System.Web.UI.WebControls.BoundField> object is displayed differently depending on the data-bound control in which it is used. For example, the <xref:System.Web.UI.WebControls.GridView> control displays a <xref:System.Web.UI.WebControls.BoundField> object as a column, while the <xref:System.Web.UI.WebControls.DetailsView> control displays it as a row.  
-  
- To specify the field to display in a <xref:System.Web.UI.WebControls.BoundField> object, set the <xref:System.Web.UI.WebControls.BoundField.DataField%2A> property to the field's name. The field's value can be HTML-encoded before it is displayed by setting the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to `true`. You can apply a custom formatting string to the field's value by setting the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property. When the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property is `true`, the encoded string value of the field is used in the custom format string. By default, the formatting string is applied to field values only when the data-bound control is in read-only mode. To apply the formatting string to values displayed while the data-bound control is in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to `true`. If a field's value is null, you can display a custom caption by setting the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property. The <xref:System.Web.UI.WebControls.BoundField> object can also automatically convert empty string ("") field values to null values by setting the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to `true`.  
-  
- You can hide a <xref:System.Web.UI.WebControls.BoundField> object in a data-bound control by setting the <xref:System.Web.UI.WebControls.DataControlField.Visible%2A> property to `false`. To prevent the value of a field from being modified in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property to `true`. In data-bound controls that support inserting records (such as the <xref:System.Web.UI.WebControls.DetailsView> control), you can hide a <xref:System.Web.UI.WebControls.BoundField> object by setting the <xref:System.Web.UI.WebControls.DataControlField.InsertVisible%2A> property to `false`. This is commonly done when you want to hide an automatically generated key field in insert mode.  
-  
- You can customize the header and footer sections of a <xref:System.Web.UI.WebControls.BoundField> object. To display a caption in the header or footer sections, set the <xref:System.Web.UI.WebControls.DataControlField.HeaderText%2A> or <xref:System.Web.UI.WebControls.DataControlField.FooterText%2A> properties, respectively. Instead of displaying text in the header section, you can display an image by setting the <xref:System.Web.UI.WebControls.DataControlField.HeaderImageUrl%2A> property. The header section can be hidden in the <xref:System.Web.UI.WebControls.BoundField> object by setting the <xref:System.Web.UI.WebControls.DataControlField.ShowHeader%2A> property to `false`.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField> class is used by data-bound controls (such as <xref:System.Web.UI.WebControls.GridView> and <xref:System.Web.UI.WebControls.DetailsView>) to display the value of a field as text. The <xref:System.Web.UI.WebControls.BoundField> object is displayed differently depending on the data-bound control in which it is used. For example, the <xref:System.Web.UI.WebControls.GridView> control displays a <xref:System.Web.UI.WebControls.BoundField> object as a column, while the <xref:System.Web.UI.WebControls.DetailsView> control displays it as a row.
+
+ To specify the field to display in a <xref:System.Web.UI.WebControls.BoundField> object, set the <xref:System.Web.UI.WebControls.BoundField.DataField%2A> property to the field's name. The field's value can be HTML-encoded before it is displayed by setting the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to `true`. You can apply a custom formatting string to the field's value by setting the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property. When the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property is `true`, the encoded string value of the field is used in the custom format string. By default, the formatting string is applied to field values only when the data-bound control is in read-only mode. To apply the formatting string to values displayed while the data-bound control is in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to `true`. If a field's value is null, you can display a custom caption by setting the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property. The <xref:System.Web.UI.WebControls.BoundField> object can also automatically convert empty string ("") field values to null values by setting the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to `true`.
+
+ You can hide a <xref:System.Web.UI.WebControls.BoundField> object in a data-bound control by setting the <xref:System.Web.UI.WebControls.DataControlField.Visible%2A> property to `false`. To prevent the value of a field from being modified in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property to `true`. In data-bound controls that support inserting records (such as the <xref:System.Web.UI.WebControls.DetailsView> control), you can hide a <xref:System.Web.UI.WebControls.BoundField> object by setting the <xref:System.Web.UI.WebControls.DataControlField.InsertVisible%2A> property to `false`. This is commonly done when you want to hide an automatically generated key field in insert mode.
+
+ You can customize the header and footer sections of a <xref:System.Web.UI.WebControls.BoundField> object. To display a caption in the header or footer sections, set the <xref:System.Web.UI.WebControls.DataControlField.HeaderText%2A> or <xref:System.Web.UI.WebControls.DataControlField.FooterText%2A> properties, respectively. Instead of displaying text in the header section, you can display an image by setting the <xref:System.Web.UI.WebControls.DataControlField.HeaderImageUrl%2A> property. The header section can be hidden in the <xref:System.Web.UI.WebControls.BoundField> object by setting the <xref:System.Web.UI.WebControls.DataControlField.ShowHeader%2A> property to `false`.
+
 > [!NOTE]
->  Some data-bound controls (such as the <xref:System.Web.UI.WebControls.GridView> control) can show or hide only the entire header section of the control. These data-bound controls do not support the <xref:System.Web.UI.WebControls.DataControlField.ShowHeader%2A> property for an individual bound field. To show or hide the entire header section of a data-bound control (if available), use the control's `ShowHeader` property.  
-  
- You also can customize the appearance of the <xref:System.Web.UI.WebControls.BoundField> object (font color, background color, and so on) by setting the style properties for the different parts of the field. The following table lists the different style properties.  
-  
-|Style property|Description|  
-|--------------------|-----------------|  
-|<xref:System.Web.UI.WebControls.DataControlField.ControlStyle%2A>|The style settings for the child Web server controls of the <xref:System.Web.UI.WebControls.BoundField> object.|  
-|<xref:System.Web.UI.WebControls.DataControlField.FooterStyle%2A>|The style settings for the footer section of the <xref:System.Web.UI.WebControls.BoundField> object.|  
-|<xref:System.Web.UI.WebControls.DataControlField.HeaderStyle%2A>|The style settings for the header section of the <xref:System.Web.UI.WebControls.BoundField> object.|  
-|<xref:System.Web.UI.WebControls.DataControlField.ItemStyle%2A>|The style settings for the data items in the <xref:System.Web.UI.WebControls.BoundField> object.|  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use a <xref:System.Web.UI.WebControls.BoundField> object to display the values of a field in a <xref:System.Web.UI.WebControls.GridView> control.  
-  
+>  Some data-bound controls (such as the <xref:System.Web.UI.WebControls.GridView> control) can show or hide only the entire header section of the control. These data-bound controls do not support the <xref:System.Web.UI.WebControls.DataControlField.ShowHeader%2A> property for an individual bound field. To show or hide the entire header section of a data-bound control (if available), use the control's `ShowHeader` property.
+
+ You also can customize the appearance of the <xref:System.Web.UI.WebControls.BoundField> object (font color, background color, and so on) by setting the style properties for the different parts of the field. The following table lists the different style properties.
+
+|Style property|Description|
+|--------------------|-----------------|
+|<xref:System.Web.UI.WebControls.DataControlField.ControlStyle%2A>|The style settings for the child Web server controls of the <xref:System.Web.UI.WebControls.BoundField> object.|
+|<xref:System.Web.UI.WebControls.DataControlField.FooterStyle%2A>|The style settings for the footer section of the <xref:System.Web.UI.WebControls.BoundField> object.|
+|<xref:System.Web.UI.WebControls.DataControlField.HeaderStyle%2A>|The style settings for the header section of the <xref:System.Web.UI.WebControls.BoundField> object.|
+|<xref:System.Web.UI.WebControls.DataControlField.ItemStyle%2A>|The style settings for the data items in the <xref:System.Web.UI.WebControls.BoundField> object.|
+
+
+
+## Examples
+ The following code example demonstrates how to use a <xref:System.Web.UI.WebControls.BoundField> object to display the values of a field in a <xref:System.Web.UI.WebControls.GridView> control.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/BoundField/CS/boundfieldcs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundField/VB/boundfieldvb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundField/VB/boundfieldvb.aspx" id="Snippet1":::
+
  ]]></format>
     </remarks>
     <altmember cref="T:System.Web.UI.WebControls.GridView" />
@@ -93,24 +93,24 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.Web.UI.WebControls.BoundField" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use this constructor to initialize a new instance of the <xref:System.Web.UI.WebControls.BoundField> class. This constructor is commonly used when adding fields to a dynamically created data-bound control.  
-  
- To dynamically add a <xref:System.Web.UI.WebControls.BoundField> object to a data-bound control, create a new <xref:System.Web.UI.WebControls.BoundField> object, set its properties, and then add it to the data-bound control's field collection. For example, if you are using the <xref:System.Web.UI.WebControls.GridView> control, add the <xref:System.Web.UI.WebControls.BoundField> object to the <xref:System.Web.UI.WebControls.GridView.Columns%2A> collection.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use this constructor to initialize a new instance of the <xref:System.Web.UI.WebControls.BoundField> class. This constructor is commonly used when adding fields to a dynamically created data-bound control.
+
+ To dynamically add a <xref:System.Web.UI.WebControls.BoundField> object to a data-bound control, create a new <xref:System.Web.UI.WebControls.BoundField> object, set its properties, and then add it to the data-bound control's field collection. For example, if you are using the <xref:System.Web.UI.WebControls.GridView> control, add the <xref:System.Web.UI.WebControls.BoundField> object to the <xref:System.Web.UI.WebControls.GridView.Columns%2A> collection.
+
 > [!NOTE]
->  Although you can dynamically add fields to a data-bound control, it is strongly recommended that fields be statically declared and then shown or hidden, as appropriate. Statically declaring all of your fields reduces the size of the view state for the parent data-bound control.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the constructor to dynamically add a <xref:System.Web.UI.WebControls.BoundField> object to a <xref:System.Web.UI.WebControls.GridView> control.  
-  
+>  Although you can dynamically add fields to a data-bound control, it is strongly recommended that fields be statically declared and then shown or hidden, as appropriate. Statically declaring all of your fields reduces the size of the view state for the parent data-bound control.
+
+
+
+## Examples
+ The following code example demonstrates how to use the constructor to dynamically add a <xref:System.Web.UI.WebControls.BoundField> object to a <xref:System.Web.UI.WebControls.GridView> control.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/BoundFieldCtor/CS/boundfieldctorcs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundFieldCtor/VB/boundfieldctorvb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundFieldCtor/VB/boundfieldctorvb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Web.UI.WebControls.GridView" />
@@ -144,22 +144,22 @@
         <value>
           <see langword="true" /> to apply the formatting string to field values in edit mode; otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Data-bound controls (such as <xref:System.Web.UI.WebControls.DetailsView>, <xref:System.Web.UI.WebControls.FormView>, and <xref:System.Web.UI.WebControls.GridView>) have different display modes that allow the user to read, edit, or insert records. By default, the formatting string specified by the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property is applied to field values only when the data-bound control is in read-only mode. To apply the formatting string to values displayed while the data-bound control is in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to `true`.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Data-bound controls (such as <xref:System.Web.UI.WebControls.DetailsView>, <xref:System.Web.UI.WebControls.FormView>, and <xref:System.Web.UI.WebControls.GridView>) have different display modes that allow the user to read, edit, or insert records. By default, the formatting string specified by the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property is applied to field values only when the data-bound control is in read-only mode. To apply the formatting string to values displayed while the data-bound control is in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to `true`.
+
 > [!NOTE]
->  A <xref:System.Web.UI.WebControls.BoundField> object does not automatically remove the formatting when the field is updated in the data source. If you do not want the formatting as part of the value stored, you will need to remove the formatting programmatically.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to apply the formatting string to field values while a <xref:System.Web.UI.WebControls.GridView> control is in edit mode. The formatting is then programmatically removed before the value is updated in the data source.  
-  
+>  A <xref:System.Web.UI.WebControls.BoundField> object does not automatically remove the formatting when the field is updated in the data source. If you do not want the formatting as part of the value stored, you will need to remove the formatting programmatically.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to apply the formatting string to field values while a <xref:System.Web.UI.WebControls.GridView> control is in edit mode. The formatting is then programmatically removed before the value is updated in the data source.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/boundfieldapplyformatineditmode/CS/boundfieldapplyformatineditmodecs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/boundfieldapplyformatineditmode/VB/boundfieldapplyformatineditmodevb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/boundfieldapplyformatineditmode/VB/boundfieldapplyformatineditmodevb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.DataFormatString" />
@@ -194,22 +194,22 @@
         <value>
           <see langword="true" /> to automatically convert empty string values to null values; otherwise, the <see langword="false" />. The default is <see langword="true" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Sometimes the user might enter an empty string for a field value when updating or inserting records. Use the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to specify whether an empty string value is automatically converted to null when the data field is updated in the data source.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Sometimes the user might enter an empty string for a field value when updating or inserting records. Use the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to specify whether an empty string value is automatically converted to null when the data field is updated in the data source.
+
 > [!NOTE]
->  By default, a <xref:System.Web.UI.WebControls.BoundField> object displays null values as empty strings. To display a different value, set the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to specify that an empty string ("") field value should automatically be converted to null.  
-  
+>  By default, a <xref:System.Web.UI.WebControls.BoundField> object displays null values as empty strings. To display a different value, set the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to specify that an empty string ("") field value should automatically be converted to null.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/boundfieldconvertemptystringtonull/CS/boundfieldconvertemptystingtonullcs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/boundfieldconvertemptystringtonull/VB/boundfieldconvertemptystingtonullvb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/boundfieldconvertemptystringtonull/VB/boundfieldconvertemptystingtonullvb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.DataField" />
@@ -240,11 +240,11 @@
         <param name="newField">The <see cref="T:System.Web.UI.WebControls.DataControlField" /> to copy the properties of the current <see cref="T:System.Web.UI.WebControls.BoundField" /> to.</param>
         <summary>Copies the properties of the current <see cref="T:System.Web.UI.WebControls.BoundField" /> object to the specified <see cref="T:System.Web.UI.WebControls.DataControlField" /> object.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.CopyProperties%2A> method is a helper method used by the <xref:System.Web.UI.WebControls.DataControlField.CloneField%2A?displayProperty=nameWithType> method to copy the properties of the current <xref:System.Web.UI.WebControls.BoundField> object to the <xref:System.Web.UI.WebControls.DataControlField> object created by the method.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.CopyProperties%2A> method is a helper method used by the <xref:System.Web.UI.WebControls.DataControlField.CloneField%2A?displayProperty=nameWithType> method to copy the properties of the current <xref:System.Web.UI.WebControls.BoundField> object to the <xref:System.Web.UI.WebControls.DataControlField> object created by the method.
+
  ]]></format>
         </remarks>
         <altmember cref="M:System.Web.UI.WebControls.DataControlField.CloneField" />
@@ -272,11 +272,11 @@
         <summary>Creates an empty <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</summary>
         <returns>An empty <see cref="T:System.Web.UI.WebControls.BoundField" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.CreateField%2A> method is a helper method used by the <xref:System.Web.UI.WebControls.DataControlField.CloneField%2A?displayProperty=nameWithType> method to create an empty <xref:System.Web.UI.WebControls.BoundField> object to copy the properties of the current <xref:System.Web.UI.WebControls.BoundField> object to.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.CreateField%2A> method is a helper method used by the <xref:System.Web.UI.WebControls.DataControlField.CloneField%2A?displayProperty=nameWithType> method to create an empty <xref:System.Web.UI.WebControls.BoundField> object to copy the properties of the current <xref:System.Web.UI.WebControls.BoundField> object to.
+
  ]]></format>
         </remarks>
         <altmember cref="M:System.Web.UI.WebControls.DataControlField.CloneField" />
@@ -317,22 +317,22 @@
         <summary>Gets or sets the name of the data field to bind to the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</summary>
         <value>The name of the data field to bind to the <see cref="T:System.Web.UI.WebControls.BoundField" />. The default is an empty string (""), which indicates that this property is not set.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Web.UI.WebControls.BoundField.DataField%2A> property to specify the name of the data field to bind to the <xref:System.Web.UI.WebControls.BoundField> object. The values of the specified field are displayed in the <xref:System.Web.UI.WebControls.BoundField> object as text. You can optionally format the displayed text by setting the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Web.UI.WebControls.BoundField.DataField%2A> property to specify the name of the data field to bind to the <xref:System.Web.UI.WebControls.BoundField> object. The values of the specified field are displayed in the <xref:System.Web.UI.WebControls.BoundField> object as text. You can optionally format the displayed text by setting the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property.
+
 > [!NOTE]
->  If a field's value is null, an empty string ("") is displayed for the value by default. To specify an alternate caption, set the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.DataField%2A> property to specify which field to display in a <xref:System.Web.UI.WebControls.BoundField> field column of a <xref:System.Web.UI.WebControls.GridView> control.  
-  
+>  If a field's value is null, an empty string ("") is displayed for the value by default. To specify an alternate caption, set the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.DataField%2A> property to specify which field to display in a <xref:System.Web.UI.WebControls.BoundField> field column of a <xref:System.Web.UI.WebControls.GridView> control.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/BoundField/CS/boundfieldcs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundField/VB/boundfieldvb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundField/VB/boundfieldvb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.DataFormatString" />
@@ -365,78 +365,76 @@
         <summary>Gets or sets the string that specifies the display format for the value of the field.</summary>
         <value>A formatting string that specifies the display format for the value of the field. The default is an empty string (""), which indicates that no special formatting is applied to the field value.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property to specify a custom display format for the values that are displayed in the <xref:System.Web.UI.WebControls.BoundField> object. If the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property is not set, the field's value is displayed without any special formatting.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property to specify a custom display format for the values that are displayed in the <xref:System.Web.UI.WebControls.BoundField> object. If the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property is not set, the field's value is displayed without any special formatting.
+
 > [!NOTE]
->  In versions of ASP.NET earlier than 3.5, you must set the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to `false` in order to format fields that are not string data types. Otherwise, the field value is converted to a string by the default conversion method before the format string that is stored in the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property is applied.  
-  
- By default, the formatting string is applied to the field value only when the data-bound control that contains the <xref:System.Web.UI.WebControls.BoundField> object is in read-only mode. To apply the formatting string to field values while in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to `true`.  
-  
- The formatting string can be any literal string and usually includes a placeholder for the field's value. For example, in the formatting string `Item Value: {0}`, the field's value is substituted for the {0} placeholder when the string is displayed in the <xref:System.Web.UI.WebControls.BoundField> object. The rest of the formatting string is displayed as literal text.  
-  
- If the formatting string does not include a placeholder, only the formatting string itself is included in the final display text (the field's value from the data source is not included). If the placeholder is a 0 (zero) enclosed in curly braces as shown in the preceding example, the field value is converted to a string by the default method. You can append to the zero a string that specifies how the field value should be formatted. For example, the placeholder `{0:C}` for a numeric field specifies that value of the field should be converted to a currency format.  
-  
- Formatting is applied by using the <xref:System.String.Format%2A> method. The number that follows the left curly brace is part of the syntax used by that method and indicates which one of a series of values the placeholder should use. Because there is only one field value in each cell, the number that follows the left curly brace can only be set to 0.  
-  
- The following table lists the standard format characters for numeric fields. These format characters are not case-sensitive, except for `X`, which displays hexadecimal characters in the case that is specified. You can append a number to most format characters in order to specify how many significant digits or decimal places you want to display.  
-  
+>  In versions of ASP.NET earlier than 3.5, you must set the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to `false` in order to format fields that are not string data types. Otherwise, the field value is converted to a string by the default conversion method before the format string that is stored in the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property is applied.
+
+ By default, the formatting string is applied to the field value only when the data-bound control that contains the <xref:System.Web.UI.WebControls.BoundField> object is in read-only mode. To apply the formatting string to field values while in edit mode, set the <xref:System.Web.UI.WebControls.BoundField.ApplyFormatInEditMode%2A> property to `true`.
+
+ The formatting string can be any literal string and usually includes a placeholder for the field's value. For example, in the formatting string `Item Value: {0}`, the field's value is substituted for the {0} placeholder when the string is displayed in the <xref:System.Web.UI.WebControls.BoundField> object. The rest of the formatting string is displayed as literal text.
+
+ If the formatting string does not include a placeholder, only the formatting string itself is included in the final display text (the field's value from the data source is not included). If the placeholder is a 0 (zero) enclosed in curly braces as shown in the preceding example, the field value is converted to a string by the default method. You can append to the zero a string that specifies how the field value should be formatted. For example, the placeholder `{0:C}` for a numeric field specifies that value of the field should be converted to a currency format.
+
+ Formatting is applied by using the <xref:System.String.Format%2A> method. The number that follows the left curly brace is part of the syntax used by that method and indicates which one of a series of values the placeholder should use. Because there is only one field value in each cell, the number that follows the left curly brace can only be set to 0.
+
+ The following table lists the standard format characters for numeric fields. These format characters are not case-sensitive, except for `X`, which displays hexadecimal characters in the case that is specified. You can append a number to most format characters in order to specify how many significant digits or decimal places you want to display.
+
 > [!NOTE]
->  In most cases, formatting depends on the server's culture setting. The examples are for a culture setting of `en-US`.  
-  
-|Format character|Description|Example|  
-|----------------------|-----------------|-------------|  
-|`C` or `c`|Displays numeric values in currency format. You can specify the number of decimal places.|Format: `{0:C}`<br /><br /> 123.456 -> $123.46<br /><br /> Format: `{0:C3}`<br /><br /> 123.456  -> $123.456|  
-|`D` or `d`|Displays integer values in decimal format. You can specify the number of digits. (Although the type is referred to as "decimal", the numbers are formatted as integers.)|Format: `{0:D}`<br /><br /> 1234 -> 1234<br /><br /> Format: `{0:D6}`<br /><br /> 1234  -> 001234|  
-|`E` or `e`|Displays numeric values in scientific (exponential) format. You can specify the number of decimal places.|Format: `{0:E}`<br /><br /> 1052.0329112756 -> 1.052033E+003<br /><br /> Format: `{0:E2}`<br /><br /> -1052.0329112756 -> -1.05e+003|  
-|`F` or `f`|Displays numeric values in fixed format. You can specify the number of decimal places.|Format: `{0:F}`<br /><br /> 1234.567 -> 1234.57<br /><br /> Format: `{0:F3}`<br /><br /> 1234.567 -> 1234.567|  
-|`G` or `g`|Displays numeric values in general format (the most compact of either fixed-point or scientific notation). You can specify the number of significant digits.|Format: `{0:G}`<br /><br /> -123.456 -> -123.456<br /><br /> Format: `{0:G2}`<br /><br /> -123.456 -> -120|  
-|`N` or `n`|Displays numeric values in number format (including group separators and optional negative sign). You can specify the number of decimal places.|Format: `{0:N}`<br /><br /> 1234.567 -> 1,234.57<br /><br /> Format: `{0:N4}`<br /><br /> 1234.567 -> 1,234.5670|  
-|`P` or `p`|Displays numeric values in percent format. You can specify the number of decimal places.|Format: `{0:P}`<br /><br /> 1 -> 100.00%<br /><br /> Format: `{0:P1}`<br /><br /> .5 -> 50.0%|  
-|`R` or `r`|Displays <xref:System.Single>, <xref:System.Double>, or `BigInteger` values in round-trip format.|Format: `{0:R}`<br /><br /> 123456789.12345678 -> 123456789.12345678|  
-|`X` or `x`|Displays integer values in hexadecimal format. You can specify the number of digits.|Format: `{0:X}`<br /><br /> 255 -> FF<br /><br /> Format: `{0:x4}`<br /><br /> 255  -> 00ff|  
-  
- For more information and for examples that show formatting for other culture values, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings). You can also create custom numeric format strings. For more information, see [Custom Numeric Format Strings](/dotnet/standard/base-types/custom-numeric-format-strings).  
-  
- The following table lists format characters for <xref:System.DateTime> fields. Most of these formatting specifications result in a different output depending on culture settings. The examples are for a <xref:System.DateTime> value of 6/15/2009 1:45:30 PM with a culture setting of `en-US`.  
-  
-|Format character|Description|Example|  
-|----------------------|-----------------|-------------|  
-|`d`|Short date pattern.|Format: `{0:d}`<br /><br /> 6/15/2009 1:45:30 PM -> 6/15/2009|  
-|`D`|Long date pattern.|Format: `{0:D}`<br /><br /> 6/15/2009 1:45:30 PM ->Monday, June 15, 2009|  
-|`f`|Full date/time pattern (short time).|Format: `{0:f}`<br /><br /> 6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM|  
-|`F`|Full date/time pattern (long time).|Format: `{0:F}`<br /><br /> 6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM|  
-|`g`|General date/time pattern (short time).|Format: `{0:g}`<br /><br /> 6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM|  
-|`G`|General date/time pattern (long time).|Format: `{0:G}`<br /><br /> 6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM|  
-|`M` or `m`|Month/day pattern.|Format: `{0:M}`<br /><br /> 6/15/2009 1:45:30 PM -> June 15|  
-|`O` or `o`|Round-trip date/time pattern.|Format: `{0:o}`<br /><br /> 6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000|  
-|`R` or `r`|RFC1123 pattern (for information, see <xref:System.Globalization.DateTimeFormatInfo.RFC1123Pattern%2A?displayProperty=nameWithType>).|Format: `{0:R}`<br /><br /> 6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT|  
-|`s`|Sortable date/time pattern.|Format: `{0:s}`<br /><br /> 6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30|  
-|`t`|Short time pattern.|Format: `{0:t}`<br /><br /> 6/15/2009 1:45:30 PM -> 1:45 PM|  
-|`T`|Long time pattern.|Format: `{0:T}`<br /><br /> 6/15/2009 1:45:30 PM -> 1:45:30 PM|  
-|`u`|Universal sortable date/time pattern.|Format: `{0:u}`<br /><br /> 6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z|  
-|`U`|Universal full date/time pattern.|Format: `{0:U}`<br /><br /> 6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM|  
-|`Y` or `y`|Year month pattern.|Format: `{0:Y}`<br /><br /> 6/15/2009 1:45:30 PM -> June, 2009|  
-  
- For more information and for examples that show formatting for other culture values, see [Standard Date and Time Format Strings](/dotnet/standard/base-types/standard-date-and-time-format-strings). You can also create custom date and time format strings. For more information, see [Custom Date and Time Format Strings](/dotnet/standard/base-types/custom-date-and-time-format-strings).  
-  
-   
-  
-## Examples  
- A Visual Studio Web site project with source code is available to accompany this topic: [Download](https://go.microsoft.com/fwlink/?LinkId=191889).  
-  
- The following example shows how to use the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property to specify a custom display format for the values of a field.  
-  
-  
-  
- The following example shows one row of the output that is produced by this example.  
-  
-|ProductID|Name|ProductNumber|ListPrice|Weight|ModifiedDate|  
-|---------------|----------|-------------------|---------------|------------|------------------|  
-|`000680`|`HL Road Frame - Black, 58`|`#FR-R92B-58`|`$1,431.50`|`1016.040`|`3/11/2004`|  
-  
+>  In most cases, formatting depends on the server's culture setting. The examples are for a culture setting of `en-US`.
+
+|Format character|Description|Example|
+|----------------------|-----------------|-------------|
+|`C` or `c`|Displays numeric values in currency format. You can specify the number of decimal places.|Format: `{0:C}`<br /><br /> 123.456 -> \\$123.46<br /><br /> Format: `{0:C3}`<br /><br /> 123.456  -> \\$123.456|
+|`D` or `d`|Displays integer values in decimal format. You can specify the number of digits. (Although the type is referred to as "decimal", the numbers are formatted as integers.)|Format: `{0:D}`<br /><br /> 1234 -> 1234<br /><br /> Format: `{0:D6}`<br /><br /> 1234  -> 001234|
+|`E` or `e`|Displays numeric values in scientific (exponential) format. You can specify the number of decimal places.|Format: `{0:E}`<br /><br /> 1052.0329112756 -> 1.052033E+003<br /><br /> Format: `{0:E2}`<br /><br /> -1052.0329112756 -> -1.05e+003|
+|`F` or `f`|Displays numeric values in fixed format. You can specify the number of decimal places.|Format: `{0:F}`<br /><br /> 1234.567 -> 1234.57<br /><br /> Format: `{0:F3}`<br /><br /> 1234.567 -> 1234.567|
+|`G` or `g`|Displays numeric values in general format (the most compact of either fixed-point or scientific notation). You can specify the number of significant digits.|Format: `{0:G}`<br /><br /> -123.456 -> -123.456<br /><br /> Format: `{0:G2}`<br /><br /> -123.456 -> -120|
+|`N` or `n`|Displays numeric values in number format (including group separators and optional negative sign). You can specify the number of decimal places.|Format: `{0:N}`<br /><br /> 1234.567 -> 1,234.57<br /><br /> Format: `{0:N4}`<br /><br /> 1234.567 -> 1,234.5670|
+|`P` or `p`|Displays numeric values in percent format. You can specify the number of decimal places.|Format: `{0:P}`<br /><br /> 1 -> 100.00%<br /><br /> Format: `{0:P1}`<br /><br /> .5 -> 50.0%|
+|`R` or `r`|Displays <xref:System.Single>, <xref:System.Double>, or `BigInteger` values in round-trip format.|Format: `{0:R}`<br /><br /> 123456789.12345678 -> 123456789.12345678|
+|`X` or `x`|Displays integer values in hexadecimal format. You can specify the number of digits.|Format: `{0:X}`<br /><br /> 255 -> FF<br /><br /> Format: `{0:x4}`<br /><br /> 255  -> 00ff|
+
+ For more information and for examples that show formatting for other culture values, see [Standard Numeric Format Strings](/dotnet/standard/base-types/standard-numeric-format-strings). You can also create custom numeric format strings. For more information, see [Custom Numeric Format Strings](/dotnet/standard/base-types/custom-numeric-format-strings).
+
+ The following table lists format characters for <xref:System.DateTime> fields. Most of these formatting specifications result in a different output depending on culture settings. The examples are for a <xref:System.DateTime> value of 6/15/2009 1:45:30 PM with a culture setting of `en-US`.
+
+|Format character|Description|Example|
+|----------------------|-----------------|-------------|
+|`d`|Short date pattern.|Format: `{0:d}`<br /><br /> 6/15/2009 1:45:30 PM -> 6/15/2009|
+|`D`|Long date pattern.|Format: `{0:D}`<br /><br /> 6/15/2009 1:45:30 PM ->Monday, June 15, 2009|
+|`f`|Full date/time pattern (short time).|Format: `{0:f}`<br /><br /> 6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM|
+|`F`|Full date/time pattern (long time).|Format: `{0:F}`<br /><br /> 6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM|
+|`g`|General date/time pattern (short time).|Format: `{0:g}`<br /><br /> 6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM|
+|`G`|General date/time pattern (long time).|Format: `{0:G}`<br /><br /> 6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM|
+|`M` or `m`|Month/day pattern.|Format: `{0:M}`<br /><br /> 6/15/2009 1:45:30 PM -> June 15|
+|`O` or `o`|Round-trip date/time pattern.|Format: `{0:o}`<br /><br /> 6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000|
+|`R` or `r`|RFC1123 pattern (for information, see <xref:System.Globalization.DateTimeFormatInfo.RFC1123Pattern%2A?displayProperty=nameWithType>).|Format: `{0:R}`<br /><br /> 6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT|
+|`s`|Sortable date/time pattern.|Format: `{0:s}`<br /><br /> 6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30|
+|`t`|Short time pattern.|Format: `{0:t}`<br /><br /> 6/15/2009 1:45:30 PM -> 1:45 PM|
+|`T`|Long time pattern.|Format: `{0:T}`<br /><br /> 6/15/2009 1:45:30 PM -> 1:45:30 PM|
+|`u`|Universal sortable date/time pattern.|Format: `{0:u}`<br /><br /> 6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z|
+|`U`|Universal full date/time pattern.|Format: `{0:U}`<br /><br /> 6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM|
+|`Y` or `y`|Year month pattern.|Format: `{0:Y}`<br /><br /> 6/15/2009 1:45:30 PM -> June, 2009|
+
+ For more information and for examples that show formatting for other culture values, see [Standard Date and Time Format Strings](/dotnet/standard/base-types/standard-date-and-time-format-strings). You can also create custom date and time format strings. For more information, see [Custom Date and Time Format Strings](/dotnet/standard/base-types/custom-date-and-time-format-strings).
+
+
+
+## Examples
+ A Visual Studio Web site project with source code is available to accompany this topic: [Download](https://go.microsoft.com/fwlink/?LinkId=191889).
+
+ The following example shows how to use the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property to specify a custom display format for the values of a field.
+
+ The following example shows one row of the output that is produced by this example.
+
+|ProductID|Name|ProductNumber|ListPrice|Weight|ModifiedDate|
+|---------------|----------|-------------------|---------------|------------|------------------|
+|`000680`|`HL Road Frame - Black, 58`|`#FR-R92B-58`|`$1,431.50`|`1016.040`|`3/11/2004`|
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.DataField" />
@@ -474,19 +472,19 @@
           <see langword="true" /> to include the values of read-only fields; otherwise, <see langword="false" />.</param>
         <summary>Fills the specified <see cref="T:System.Collections.IDictionary" /> object with the values from the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> object.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.ExtractValuesFromCell%2A> method is provided as a convenient way to retrieve the values of the fields from the specified <xref:System.Web.UI.WebControls.TableCell> object in a <xref:System.Web.UI.WebControls.BoundField> object.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.ExtractValuesFromCell%2A> method is provided as a convenient way to retrieve the values of the fields from the specified <xref:System.Web.UI.WebControls.TableCell> object in a <xref:System.Web.UI.WebControls.BoundField> object.
+
 > [!NOTE]
->  This method is used primarily by control developers.  
-  
- This method does not have a return value. Instead, the field values are returned by reference through the <xref:System.Collections.IDictionary?displayProperty=nameWithType> object passed in for the `dictionary` parameter. After the method has been called, iterate through the <xref:System.Collections.IDictionary?displayProperty=nameWithType> object to access the field values.  
-  
+>  This method is used primarily by control developers.
+
+ This method does not have a return value. Instead, the field values are returned by reference through the <xref:System.Collections.IDictionary?displayProperty=nameWithType> object passed in for the `dictionary` parameter. After the method has been called, iterate through the <xref:System.Collections.IDictionary?displayProperty=nameWithType> object to access the field values.
+
 > [!NOTE]
->  If the <xref:System.Web.UI.WebControls.TableCell> object contains read-only field values, you must pass in `true` for the `includeReadOnly` parameter to include those values.  
-  
+>  If the <xref:System.Web.UI.WebControls.TableCell> object contains read-only field values, you must pass in `true` for the `includeReadOnly` parameter to include those values.
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Collections.IDictionary" />
@@ -520,14 +518,14 @@
         <summary>Formats the specified field value for a cell in the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</summary>
         <returns>The field value converted to the format specified by <see cref="P:System.Web.UI.WebControls.BoundField.DataFormatString" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.FormatDataValue%2A> method is a helper method used to transform a field value to the format specified by the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property. If a field value is null, the value of the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property is returned.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.FormatDataValue%2A> method is a helper method used to transform a field value to the format specified by the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property. If a field value is null, the value of the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property is returned.
+
 > [!NOTE]
->  This method is used primarily by control developers.  
-  
+>  This method is used primarily by control developers.
+
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
@@ -556,14 +554,14 @@
         <summary>Retrieves the value used for a field's value when rendering the <see cref="T:System.Web.UI.WebControls.BoundField" /> object in a designer.</summary>
         <returns>The value to display in the designer as the field's value.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.GetDesignTimeValue%2A> method is a helper method used to determine what value to display for a field when rendering the <xref:System.Web.UI.WebControls.BoundField> object in a designer. If real data cannot be retrieved from the data source at design time, the value returned by this method is displayed instead.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.GetDesignTimeValue%2A> method is a helper method used to determine what value to display for a field when rendering the <xref:System.Web.UI.WebControls.BoundField> object in a designer. If real data cannot be retrieved from the data source at design time, the value returned by this method is displayed instead.
+
 > [!NOTE]
->  This method is used primarily by control developers.  
-  
+>  This method is used primarily by control developers.
+
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
@@ -596,24 +594,24 @@
         <summary>Retrieves the value of the field bound to the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</summary>
         <returns>The value of the field bound to the <see cref="T:System.Web.UI.WebControls.BoundField" />.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.GetValue%2A> method is a helper method used to determine the value of a field. If the <xref:System.Web.UI.WebControls.BoundField> object is being displayed in a designer and the field value cannot be determined at design time, the value returned from the <xref:System.Web.UI.WebControls.BoundField.GetDesignTimeValue%2A> method is returned instead of the actual field value.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.GetValue%2A> method is a helper method used to determine the value of a field. If the <xref:System.Web.UI.WebControls.BoundField> object is being displayed in a designer and the field value cannot be determined at design time, the value returned from the <xref:System.Web.UI.WebControls.BoundField.GetDesignTimeValue%2A> method is returned instead of the actual field value.
+
 > [!NOTE]
->  This method is used primarily by control developers.  
-  
+>  This method is used primarily by control developers.
+
  ]]></format>
         </remarks>
-        <exception cref="T:System.Web.HttpException">The container specified by the <paramref name="controlContainer" /> parameter is <see langword="null" />.  
-  
+        <exception cref="T:System.Web.HttpException">The container specified by the <paramref name="controlContainer" /> parameter is <see langword="null" />.
+
 -or-
-  
- The container specified by the <paramref name="controlContainer" /> parameter does not have a data item.  
-  
+
+ The container specified by the <paramref name="controlContainer" /> parameter does not have a data item.
+
 -or-
-  
+
  The data field was not found.</exception>
         <block subset="none" type="overrides">
           <para>When extending the <see cref="T:System.Web.UI.WebControls.BoundField" /> class, you can override this method to provide a custom routine to determine a field's value.</para>
@@ -641,11 +639,11 @@
         <summary>Gets or sets the text that is displayed in the header of a data control.</summary>
         <value>The text displayed in the header of a data control. The default value is an empty string ("").</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Web.UI.WebControls.BoundField.HeaderText%2A> property to identify a field in a data control with a friendly name. The most common application of the <xref:System.Web.UI.WebControls.BoundField.HeaderText%2A> property is to provide meaningful column names to data-bound fields in a <xref:System.Web.UI.WebControls.GridView> or <xref:System.Web.UI.WebControls.DetailsView> control.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Web.UI.WebControls.BoundField.HeaderText%2A> property to identify a field in a data control with a friendly name. The most common application of the <xref:System.Web.UI.WebControls.BoundField.HeaderText%2A> property is to provide meaningful column names to data-bound fields in a <xref:System.Web.UI.WebControls.GridView> or <xref:System.Web.UI.WebControls.DetailsView> control.
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.DataField" />
@@ -678,22 +676,22 @@
         <value>
           <see langword="true" /> if field values are HTML-encoded before they are displayed in a <see cref="T:System.Web.UI.WebControls.BoundField" /> object; otherwise, <see langword="false" />. The default is <see langword="true" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to specify whether field values are HTML-encoded to their respective string representations before they are displayed in a <xref:System.Web.UI.WebControls.BoundField> object. For example, if this property is `true`, a string value of "\<script>" would be rendered as "&lt;script&gt;". If this property is `false`, the string would be rendered unchanged.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to specify whether field values are HTML-encoded to their respective string representations before they are displayed in a <xref:System.Web.UI.WebControls.BoundField> object. For example, if this property is `true`, a string value of "\<script>" would be rendered as "&lt;script&gt;". If this property is `false`, the string would be rendered unchanged.
+
 > [!NOTE]
->  HTML-encoding field values helps to prevent cross-site scripting attacks and malicious content from being displayed. This property should be enabled whenever possible.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to prevent field values from being HTML-encoded before being displayed in a <xref:System.Web.UI.WebControls.BoundField> object.  
-  
+>  HTML-encoding field values helps to prevent cross-site scripting attacks and malicious content from being displayed. This property should be enabled whenever possible.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.HtmlEncode%2A> property to prevent field values from being HTML-encoded before being displayed in a <xref:System.Web.UI.WebControls.BoundField> object.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/BoundFieldHtmlEncode/CS/BoundFieldHtmlEncodecs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundFieldHtmlEncode/VB/BoundFieldHtmlEncodevb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundFieldHtmlEncode/VB/BoundFieldHtmlEncodevb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="Overload:System.Web.HttpServerUtility.HtmlEncode" />
@@ -727,14 +725,14 @@
         <value>
           <see langword="true" /> if the text should be HTML-encoded; otherwise, <see langword="false" />. The default is <see langword="true" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- HTML-encoding values can help prevent cross-site scripting attacks and malicious content from being displayed. HTML encoding is also useful when you want to display HTML code in the browser, such as displaying the string "\<br/>" instead of inserting a line break (`<br/>` element) in the page.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ HTML-encoding values can help prevent cross-site scripting attacks and malicious content from being displayed. HTML encoding is also useful when you want to display HTML code in the browser, such as displaying the string "\<br/>" instead of inserting a line break (`<br/>` element) in the page.
+
 > [!NOTE]
->  This property is new in ASP.NET 3.5. Setting this property to `false` restores the default behavior of the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property in versions of ASP.NET earlier than 3.5. For more information, see the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property.  
-  
+>  This property is new in ASP.NET 3.5. Setting this property to `false` restores the default behavior of the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property in versions of ASP.NET earlier than 3.5. For more information, see the <xref:System.Web.UI.WebControls.BoundField.DataFormatString%2A> property.
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.HtmlEncode" />
@@ -769,13 +767,13 @@
         <returns>
           <see langword="false" /> in all cases.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.Initialize%2A> method is called by the data control with which the <xref:System.Web.UI.WebControls.BoundField> object is associated to perform basic object initialization for instances of the field, before the field is ever added to a rows collection. Data controls such as <xref:System.Web.UI.WebControls.DetailsView> and <xref:System.Web.UI.WebControls.GridView> call the <xref:System.Web.UI.WebControls.DataControlField.Initialize%2A> method in their `CreateChildControls` methods before other methods such as `CreateRow` are called to create specific rows with data.  
-  
- Call this method when you are writing a custom data-bound control that uses <xref:System.Web.UI.WebControls.TableCell> objects to perform basic initialization for a <xref:System.Web.UI.WebControls.BoundField> object. Implement this method if your <xref:System.Web.UI.WebControls.BoundField>-derived type requires any object initialization before it populates <xref:System.Web.UI.WebControls.TableCell> objects with data or controls in the <xref:System.Web.UI.WebControls.BoundField.InitializeCell%2A> method.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.Initialize%2A> method is called by the data control with which the <xref:System.Web.UI.WebControls.BoundField> object is associated to perform basic object initialization for instances of the field, before the field is ever added to a rows collection. Data controls such as <xref:System.Web.UI.WebControls.DetailsView> and <xref:System.Web.UI.WebControls.GridView> call the <xref:System.Web.UI.WebControls.DataControlField.Initialize%2A> method in their `CreateChildControls` methods before other methods such as `CreateRow` are called to create specific rows with data.
+
+ Call this method when you are writing a custom data-bound control that uses <xref:System.Web.UI.WebControls.TableCell> objects to perform basic initialization for a <xref:System.Web.UI.WebControls.BoundField> object. Implement this method if your <xref:System.Web.UI.WebControls.BoundField>-derived type requires any object initialization before it populates <xref:System.Web.UI.WebControls.TableCell> objects with data or controls in the <xref:System.Web.UI.WebControls.BoundField.InitializeCell%2A> method.
+
  ]]></format>
         </remarks>
         <altmember cref="T:System.Web.UI.WebControls.TableCell" />
@@ -813,13 +811,13 @@
         <param name="rowIndex">The zero-based index of the row.</param>
         <summary>Initializes the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> object to the specified row state.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.InitializeCell%2A> method is implemented by <xref:System.Web.UI.WebControls.BoundField>-derived types to add text and controls to a <xref:System.Web.UI.WebControls.TableCell> object of a data control that uses tables to display a user interface (UI). These data controls create the complete table structure row-by-row when the control's `CreateChildControls` method is called. The <xref:System.Web.UI.WebControls.BoundField.InitializeCell%2A> method is called by the `InitializeRow` method of data controls such as <xref:System.Web.UI.WebControls.DetailsView> and <xref:System.Web.UI.WebControls.GridView>.  
-  
- Call this method when you are writing a custom data-bound control that uses <xref:System.Web.UI.WebControls.TableCell> objects to initialize the cells of the table structure with data or controls. Implement this method when you are writing a <xref:System.Web.UI.WebControls.BoundField>-derived class.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.InitializeCell%2A> method is implemented by <xref:System.Web.UI.WebControls.BoundField>-derived types to add text and controls to a <xref:System.Web.UI.WebControls.TableCell> object of a data control that uses tables to display a user interface (UI). These data controls create the complete table structure row-by-row when the control's `CreateChildControls` method is called. The <xref:System.Web.UI.WebControls.BoundField.InitializeCell%2A> method is called by the `InitializeRow` method of data controls such as <xref:System.Web.UI.WebControls.DetailsView> and <xref:System.Web.UI.WebControls.GridView>.
+
+ Call this method when you are writing a custom data-bound control that uses <xref:System.Web.UI.WebControls.TableCell> objects to initialize the cells of the table structure with data or controls. Implement this method when you are writing a <xref:System.Web.UI.WebControls.BoundField>-derived class.
+
  ]]></format>
         </remarks>
         <altmember cref="M:System.Web.UI.WebControls.BoundField.Initialize(System.Boolean,System.Web.UI.Control)" />
@@ -851,11 +849,11 @@
         <param name="rowState">One of the <see cref="T:System.Web.UI.WebControls.DataControlRowState" /> values.</param>
         <summary>Initializes the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> object to the specified row state.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.InitializeDataCell%2A> method is a helper method used to initialize a cell in the <xref:System.Web.UI.WebControls.BoundField> object.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.InitializeDataCell%2A> method is a helper method used to initialize a cell in the <xref:System.Web.UI.WebControls.BoundField> object.
+
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
@@ -916,22 +914,22 @@
         <summary>Gets or sets the caption displayed for a field when the field's value is null.</summary>
         <value>The caption displayed for a field when the field's value is null. The default is an empty string (""), which indicates that this property is not set.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Sometimes a field's value is stored as null in the data source. You can specify a custom caption to display for fields that have a null value by setting the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property. If this property is not set, null field values are displayed as empty strings (""). When a record is being updated or inserted in a data-bound control, if the user enters the value specified by this property (other than an empty string) for a field in a data-bound control, that value is automatically converted to null in the data source.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Sometimes a field's value is stored as null in the data source. You can specify a custom caption to display for fields that have a null value by setting the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property. If this property is not set, null field values are displayed as empty strings (""). When a record is being updated or inserted in a data-bound control, if the user enters the value specified by this property (other than an empty string) for a field in a data-bound control, that value is automatically converted to null in the data source.
+
 > [!NOTE]
->  To convert an empty string field value to a null value, set the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to `true`.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property to specify a custom caption to display for null field values.  
-  
+>  To convert an empty string field value to a null value, set the <xref:System.Web.UI.WebControls.BoundField.ConvertEmptyStringToNull%2A> property to `true`.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.NullDisplayText%2A> property to specify a custom caption to display for null field values.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/BoundFieldNullDisplayText/CS/boundfieldnulldisplaytextcs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundFieldNullDisplayText/VB/boundfieldnulldisplaytextvb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundFieldNullDisplayText/VB/boundfieldnulldisplaytextvb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.BoundField.DataField" />
@@ -964,11 +962,11 @@
         <param name="e">An <see cref="T:System.EventArgs" /> that contains the event data.</param>
         <summary>Binds the value of a field to the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.CheckBoxField.OnDataBindField%2A> method is a helper method used to bind the value of a field in the data source to a corresponding cell in the <xref:System.Web.UI.WebControls.BoundField> object.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.CheckBoxField.OnDataBindField%2A> method is a helper method used to bind the value of a field in the data source to a corresponding cell in the <xref:System.Web.UI.WebControls.BoundField> object.
+
  ]]></format>
         </remarks>
         <exception cref="T:System.Web.HttpException">The control to which the field value is bound is not a <see cref="T:System.Web.UI.WebControls.TextBox" /> or a <see cref="T:System.Web.UI.WebControls.TableCell" />.</exception>
@@ -1006,22 +1004,22 @@
         <value>
           <see langword="true" /> to prevent the value of the field from being modified in edit mode; otherwise, <see langword="false" />. The default is <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- Use the <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property to prevent the values displayed in a <xref:System.Web.UI.WebControls.BoundField> object from being modified. When a data-bound control is in edit mode, fields that are read-only are displayed as plain text, without any editing controls.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ Use the <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property to prevent the values displayed in a <xref:System.Web.UI.WebControls.BoundField> object from being modified. When a data-bound control is in edit mode, fields that are read-only are displayed as plain text, without any editing controls.
+
 > [!NOTE]
->  The <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property applies only to edit mode. To prevent fields from showing up in insert mode, use the <xref:System.Web.UI.WebControls.DataControlField.InsertVisible%2A> property.  
-  
-   
-  
-## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property to prevent the values of the key field displayed in a <xref:System.Web.UI.WebControls.BoundField> object from being modified in edit mode.  
-  
+>  The <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property applies only to edit mode. To prevent fields from showing up in insert mode, use the <xref:System.Web.UI.WebControls.DataControlField.InsertVisible%2A> property.
+
+
+
+## Examples
+ The following code example demonstrates how to use the <xref:System.Web.UI.WebControls.BoundField.ReadOnly%2A> property to prevent the values of the key field displayed in a <xref:System.Web.UI.WebControls.BoundField> object from being modified in edit mode.
+
  :::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_WebNet/BoundField/CS/boundfieldcs.aspx" id="Snippet1":::
- :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundField/VB/boundfieldvb.aspx" id="Snippet1":::  
-  
+ :::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_WebNet/BoundField/VB/boundfieldvb.aspx" id="Snippet1":::
+
  ]]></format>
         </remarks>
         <altmember cref="P:System.Web.UI.WebControls.DetailsView.AutoGenerateEditButton" />
@@ -1048,11 +1046,11 @@
         <summary>Gets a value indicating whether HTML encoding is supported by a <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</summary>
         <value>Always returns <see langword="true" /> to indicate that HTML encoding is supported by a <see cref="T:System.Web.UI.WebControls.BoundField" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.SupportsHtmlEncode%2A> property is a helper property used by the <xref:System.Web.UI.WebControls.BoundField> class and derived classes to determine whether HTML encoding is supported by the class.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.SupportsHtmlEncode%2A> property is a helper property used by the <xref:System.Web.UI.WebControls.BoundField> class and derived classes to determine whether HTML encoding is supported by the class.
+
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
@@ -1081,13 +1079,13 @@
       <Docs>
         <summary>Represents the "this" expression.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This field is used to indicate that the <xref:System.Web.UI.WebControls.BoundField> object should bind against the data source itself, rather than a field of the data source. In this case, the object's `ToString` value will be displayed in the field.  
-  
- This field is used primarily by control developers.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This field is used to indicate that the <xref:System.Web.UI.WebControls.BoundField> object should bind against the data source itself, rather than a field of the data source. In this case, the object's `ToString` value will be displayed in the field.
+
+ This field is used primarily by control developers.
+
  ]]></format>
         </remarks>
         <forInternalUseOnly />
@@ -1140,14 +1138,14 @@
       <Docs>
         <summary>Determines whether the controls contained in a <see cref="T:System.Web.UI.WebControls.BoundField" /> object support callbacks.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Web.UI.WebControls.BoundField.ValidateSupportsCallback%2A> method is a helper method used to determine whether the controls contained in a <xref:System.Web.UI.WebControls.BoundField> object support callbacks. This method has been implemented as an empty method (a method that does not contain any code) to indicate that callbacks are supported.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Web.UI.WebControls.BoundField.ValidateSupportsCallback%2A> method is a helper method used to determine whether the controls contained in a <xref:System.Web.UI.WebControls.BoundField> object support callbacks. This method has been implemented as an empty method (a method that does not contain any code) to indicate that callbacks are supported.
+
 > [!NOTE]
->  This method is used primarily by control developers.  
-  
+>  This method is used primarily by control developers.
+
  ]]></format>
         </remarks>
         <block subset="none" type="overrides">
diff --git a/xml/System.Web.UI.WebControls/ListControl.xml b/xml/System.Web.UI.WebControls/ListControl.xml
index 41d63dd217a..4f20a9cdf38 100644
--- a/xml/System.Web.UI.WebControls/ListControl.xml
+++ b/xml/System.Web.UI.WebControls/ListControl.xml
@@ -564,8 +564,8 @@ The items in the <xref:System.Web.UI.WebControls.ListControl.Items> collection a
 
 |Numeric Value|Format String|Result|
 |-------------------|-------------------|------------|
-|12345.6789|"{0:C}"|$12,345.68|
-|-12345.6789|"{0:C}"|($12,345.68)|
+|12345.6789|"{0:C}"|\\$12,345.68|
+|-12345.6789|"{0:C}"|(\\$12,345.68)|
 |12345|"{0:D}"|12345|
 |12345|"{0:D8}"|00012345|
 |12345.6789|"{0:E}"|1234568E+004|
@@ -576,7 +576,7 @@ The items in the <xref:System.Web.UI.WebControls.ListControl.Items> collection a
 |123456789|"{0:G7}"|1.234568E8|
 |12345.6789|"{0:N}"|12,345.68|
 |123456789|"{0:N4}"|123,456,789.0000|
-|12345.6789|"Total: {0:C}"|Total: $12345.68|
+|12345.6789|"Total: {0:C}"|Total: \\$12345.68|
 
  For more information on formatting strings, see [Formatting Types](/dotnet/standard/base-types/formatting-types).
 
diff --git a/xml/System.Web.UI.WebControls/RegularExpressionValidator.xml b/xml/System.Web.UI.WebControls/RegularExpressionValidator.xml
index 08709698a90..3f6ac73da61 100644
--- a/xml/System.Web.UI.WebControls/RegularExpressionValidator.xml
+++ b/xml/System.Web.UI.WebControls/RegularExpressionValidator.xml
@@ -266,12 +266,10 @@
  For more information on regular expressions, see [.NET Framework Regular Expressions](/dotnet/standard/base-types/regular-expressions).
 
 > [!NOTE]
->  If you experience problems with pattern matching constructs, try wrapping the expression with "^(" and ")$". For example, "a&#124;ab" becomes "^(a&#124;ab)$".
+>  If you experience problems with pattern matching constructs, try wrapping the expression with "^(" and ")\\$". For example, "a&#124;ab" becomes "^(a&#124;ab)\\$".
 
  This property cannot be set by themes or style sheet themes. For more information, see <xref:System.Web.UI.ThemeableAttribute> and [ASP.NET Themes and Skins](https://learn.microsoft.com/previous-versions/aspnet/ykzx33wh(v=vs.100)).
 
-
-
 ## Examples
  The following example demonstrates how to use the <xref:System.Web.UI.WebControls.RegularExpressionValidator.ValidationExpression%2A> property to validate a field with five numeric digits. When the <xref:System.Web.UI.WebControls.Button> control is clicked, the resulting <xref:System.Web.UI.WebControls.Button.OnClick%2A> event handler checks the <xref:System.Web.UI.Page.IsValid%2A> property of the <xref:System.Web.UI.Page> to determine whether the text in the <xref:System.Web.UI.WebControls.TextBox> satisfies the regular expression.
 
diff --git a/xml/System/Byte.xml b/xml/System/Byte.xml
index 37e6c69f76b..7d9055a518c 100644
--- a/xml/System/Byte.xml
+++ b/xml/System/Byte.xml
@@ -1607,12 +1607,12 @@ For <xref:System.Numerics.IFloatingPoint%601>, this method matches the IEEE 754:
         <param name="s">A string that contains a number to convert. The string is interpreted using the style specified by <paramref name="style" />.</param>
         <param name="style">A bitwise combination of enumeration values that indicates the style elements that can be present in <paramref name="s" />. A typical value to specify is <see cref="F:System.Globalization.NumberStyles.Integer" />.</param>
         <summary>Converts the string representation of a number in a specified style to its <see cref="T:System.Byte" /> equivalent.</summary>
-        <returns>A byte value that is equivalent to the number contained in <paramref name="s" />.</returns>
+        <returns>A byte value that's equivalent to the number contained in <paramref name="s" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The `style` parameter defines the style elements (such as white space or the positive sign) that are allowed in the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the <xref:System.Globalization.NumberStyles> enumeration. Depending on the value of `style`, the `s` parameter may include the following elements:
+ The `style` parameter defines the style elements (such as white space or the positive sign) that are allowed in the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the <xref:System.Globalization.NumberStyles> enumeration. Depending on the value of `style`, the `s` parameter can include the following elements:
 
  [ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]