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 .