AzureAppConfigurationOptions.Select Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| Select(String, String) |
Specify what key-values to include in the configuration provider. Select(String, String) can be called multiple times to include multiple sets of key-values. |
| Select(String, String, IEnumerable<String>) |
Specify what key-values to include in the configuration provider. Select(String, String, IEnumerable<String>) can be called multiple times to include multiple sets of key-values. |
Select(String, String)
Specify what key-values to include in the configuration provider. Select(String, String) can be called multiple times to include multiple sets of key-values.
public Microsoft.Extensions.Configuration.AzureAppConfiguration.AzureAppConfigurationOptions Select(string keyFilter, string labelFilter = "\0");member this.Select : string * string -> Microsoft.Extensions.Configuration.AzureAppConfiguration.AzureAppConfigurationOptionsPublic Function Select (keyFilter As String, Optional labelFilter As String = "\0") As AzureAppConfigurationOptionsParameters
- keyFilter
- String
The key filter to apply when querying Azure App Configuration for key-values.
An asterisk () can be added to the end to return all key-values whose key begins with the key filter.
e.g. key filter abc* returns all key-values whose key starts with abc.
A comma (,) can be used to select multiple key-values. Comma separated filters must exactly match a key to select it.
Using asterisk to select key-values that begin with a key filter while simultaneously using comma separated key filters is not supported.
E.g. the key filter abc*,def is not supported. The key filters abc* and abc,def are supported.
For all other cases the characters: asterisk (), comma (,), and backslash () are reserved. Reserved characters must be escaped using a backslash ().
e.g. the key filter a\\b\,\*c* returns all key-values whose key starts with a\b,*c.
Built-in key filter options: KeyFilter.
- labelFilter
- String
The label filter to apply when querying Azure App Configuration for key-values. By default the null label will be used. Built-in label filter options: LabelFilter The characters asterisk (*) and comma (,) are not supported. Backslash () character is reserved and must be escaped using another backslash ().
Returns
Applies to
Select(String, String, IEnumerable<String>)
Specify what key-values to include in the configuration provider. Select(String, String, IEnumerable<String>) can be called multiple times to include multiple sets of key-values.
public Microsoft.Extensions.Configuration.AzureAppConfiguration.AzureAppConfigurationOptions Select(string keyFilter, string labelFilter = "\0", System.Collections.Generic.IEnumerable<string> tagFilters = default);member this.Select : string * string * seq<string> -> Microsoft.Extensions.Configuration.AzureAppConfiguration.AzureAppConfigurationOptionsPublic Function Select (keyFilter As String, Optional labelFilter As String = "\0", Optional tagFilters As IEnumerable(Of String) = Nothing) As AzureAppConfigurationOptionsParameters
- keyFilter
- String
The key filter to apply when querying Azure App Configuration for key-values.
An asterisk () can be added to the end to return all key-values whose key begins with the key filter.
e.g. key filter abc* returns all key-values whose key starts with abc.
A comma (,) can be used to select multiple key-values. Comma separated filters must exactly match a key to select it.
Using asterisk to select key-values that begin with a key filter while simultaneously using comma separated key filters is not supported.
E.g. the key filter abc*,def is not supported. The key filters abc* and abc,def are supported.
For all other cases the characters: asterisk (), comma (,), and backslash () are reserved. Reserved characters must be escaped using a backslash ().
e.g. the key filter a\\b\,\*c* returns all key-values whose key starts with a\b,*c.
Built-in key filter options: KeyFilter.
- labelFilter
- String
The label filter to apply when querying Azure App Configuration for key-values. By default the null label will be used. Built-in label filter options: LabelFilter The characters asterisk (*) and comma (,) are not supported. Backslash () character is reserved and must be escaped using another backslash ().
- tagFilters
- IEnumerable<String>
In addition to key and label filters, key-values from Azure App Configuration can be filtered based on their tag names and values. Each tag filter must follow the format "tagName=tagValue". Only those key-values will be loaded whose tags match all the tags provided here. Built in tag filter values: TagValue. For example, $"tagName={Null}". The characters asterisk (*), comma (,) and backslash () are reserved and must be escaped using a backslash (). Up to 5 tag filters can be provided. If no tag filters are provided, key-values will not be filtered based on tags.
