diff --git a/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml b/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml
index 3ece5dae235..c4ace7e8795 100644
--- a/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml
+++ b/xml/Microsoft.Extensions.Caching.Memory/CacheExtensions.xml
@@ -113,9 +113,9 @@
The instance this method extends.
The key of the value to get.
- Gets the value associated with this key if present.
+ Gets the value associated with this key if present and castable to .
- The value associated with this key, or default(TItem) if the key is not present.
+ The value associated with this key, or default(TItem) if the key is not present or the stored value can't be cast to .
To be added.
@@ -595,13 +595,15 @@
The type of the object to get.
The instance this method extends.
The key of the value to get.
- The value associated with the given key.
+ The value associated with the given key, or default(TItem) if the key is not found or the stored value can't be cast to .
- Tries to get the value associated with the given key.
+ Tries to get the value associated with the given key and cast it to .
- true if the key was found; false otherwise.
- To be added.
+ true if the key was found and the stored value can be cast to ; false otherwise.
+
+ This method returns false both when the key is not present in the cache and when the key is present but the stored value can't be cast to . If you need to distinguish between these two cases (for example, in instrumented caches tracking hit/miss metrics), use the non-generic method instead, which returns true if the key is present regardless of type.
+
diff --git a/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml b/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml
index 16a3fdb8b79..65e27cefa3c 100644
--- a/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml
+++ b/xml/System.Web.Security.AntiXss/AntiXssEncoder.xml
@@ -174,20 +174,20 @@
|0x0180 - 0x024F|Characters between 0x0180 (384 decimal) and 0x024F (591 decimal). (The Unicode [Latin-Extended-B](https://www.unicode.org/charts/PDF/U0180.pdf) character range.)|
|0x0250 - 0x02AF|Characters between 0x0250 (592 decimal) and 0x02AF (687 decimal). (The Unicode [IPA Extensions](https://www.unicode.org/charts/PDF/U0250.pdf) character range.)|
|0x02B0 - 0x02FF|Characters between 0x02B0 (688 decimal) and 0x02FF (767 decimal). (The Unicode [Spacing Modifier Letters](https://www.unicode.org/charts/PDF/U02B0.pdf) character range.)|
-|0x0300 - 0x036F|Characters between 0x0300 (768 decimal) and 0x036F (879 decimal). (The Unicode [Combining Diacritical Marks](https://www.unicode.org/charts/PDF/U0300.pdf) character range.)|
-
- The following table lists examples of inputs and the corresponding encoded outputs.
-
-|Input examples| Encoded outputs|
-|-|-|
-|`alert('XSS Attack!');`|`alert('XSS Attack!');`|
-|``|`<script>alert('XSS Attack!');</script>`|
-|`alert('XSSあAttack!');`|`alert('XSSあAttack!');`|
-|`user@contoso.com`|`user@contoso.com`|
-|`"Anti-Cross Site Scripting Namespace"`|`"Anti-Cross Site Scripting Namespace"`|
-
- To customize the safe list, call the method.
-
+|0x0300 - 0x036F|Characters between 0x0300 (768 decimal) and 0x036F (879 decimal). (The Unicode [Combining Diacritical Marks](https://www.unicode.org/charts/PDF/U0300.pdf) character range.)|
+
+ The following table lists examples of inputs and the corresponding encoded outputs.
+
+|Input examples| Encoded outputs|
+|-|-|
+|`alert('XSS Attack!');`|`alert('XSS Attack!');`|
+|``|`<script>alert('XSS Attack!');</script>`|
+|`alert('XSSあAttack!');`|`alert('XSSあAttack!');`|
+|`user@contoso.com`|`user@contoso.com`|
+|`"Anti-Cross Site Scripting Namespace"`|`"Anti-Cross Site Scripting Namespace"`|
+
+ To customize the safe list, call the method.
+
]]>
@@ -279,11 +279,11 @@
| Input | Output |
|------------------------------------------|---------------------------------------------------------------|
-| `alert('XSS Attack!');` | `alert('XSS Attack!');` |
+| `alert('XSS Attack!');` | `alert('XSS Attack!');` |
| `` | `<script>alert('XSS Attack!');</script>` |
| `alert('XSSあAttack!');` | `alert('XSSあAttack!');` |
| `user@contoso.com` | `user@contoso.com` |
-| `"Anti-Cross Site Scripting Namespace"` | `"Anti-Cross Site Scripting Namespace"` |
+| `"Anti-Cross Site Scripting Namespace"` | `"Anti-Cross Site Scripting Namespace"` |
To customize the safe list, call the method.
@@ -367,11 +367,11 @@
| Input | Output |
|-------|--------|
-|`alert('XSS Attack!');`|`alert('XSS Attack!');`|
+|`alert('XSS Attack!');`|`alert('XSS Attack!');`|
|``|`<script>alert('XSS Attack!');</script>`|
|`alert('XSSあAttack!');`|`alert('XSSあAttack!');`|
|`user@contoso.com`|`user@contoso.com`|
-|`"Anti-Cross Site Scripting Namespace"`|`"Anti-Cross Site Scripting Namespace"`|
+|`"Anti-Cross Site Scripting Namespace"`|`"Anti-Cross Site Scripting Namespace"`|
To customize the safe list, call the method.
diff --git a/xml/System/DateTimeOffset.xml b/xml/System/DateTimeOffset.xml
index 4a4c27b7c03..cc29c2c7576 100644
--- a/xml/System/DateTimeOffset.xml
+++ b/xml/System/DateTimeOffset.xml
@@ -293,7 +293,7 @@
A date and time.
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified value and offset.
+ Initializes a new instance of the structure using the specified value and .
A date and time expressed as the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight on January 1, 0001.
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified number of ticks and offset.
+ Initializes a new instance of the structure using the specified number of and .
The minutes (0 through 59).
The seconds (0 through 59).
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified year, month, day, hour, minute, second, and offset.
+ Initializes a new instance of the structure using the specified , , , , , , and .
The seconds (0 through 59).
The milliseconds (0 through 999).
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified year, month, day, hour, minute, second, millisecond, and offset.
+ Initializes a new instance of the structure using the specified , , , , , , , and .
The milliseconds (0 through 999).
The calendar that is used to interpret , , and .
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.
+ Initializes a new instance of the structure using the specified , , , , , , , , and .
The milliseconds (0 through 999).
The microseconds (0 through 999).
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified , , , , , , , and .
+ Initializes a new instance of the structure using the specified , , , , , , , , and .
The microseconds (0 through 999).
The calendar that is used to interpret , , and .
The time's offset from Coordinated Universal Time (UTC).
- Initializes a new instance of the structure using the specified , , , , , , , and .
+ Initializes a new instance of the structure using the specified , , , , , , , , , and .