GenericUriParser(GenericUriParserOptions) Costruttore
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea un parser personalizzabile per un URI gerarchico.
public:
GenericUriParser(GenericUriParserOptions options);
public GenericUriParser (GenericUriParserOptions options);
new GenericUriParser : GenericUriParserOptions -> GenericUriParser
Public Sub New (options As GenericUriParserOptions)
- options
- GenericUriParserOptions
Specificare le opzioni per questo oggetto GenericUriParser.
Usare questo costruttore come argomento per UriParser.Register(UriParser, String, Int32)
Se si vuole creare un parser basato su uno schema noto, usare HttpStyleUriParser, FtpStyleUriParser, GopherStyleUriParser, LdapStyleUriParsero NewsStyleUriParser.
Quando si crea un parser personalizzabile, il comportamento del parser viene specificato passando una combinazione bit per bit dei valori disponibili nell'enumerazione System.GenericUriParserOptions al GenericUriParser costruttore.
La classe esistente System.Uri è stata estesa per fornire supporto per IRI (International Resource Identifier) e IDN (Internationalized Domain Names). Gli utenti non noteranno alcun cambiamento dal comportamento di .NET Framework 2.0, a meno che non abilitino in modo specifico gli URI. Questo garantisce la compatibilità delle applicazioni con le versioni precedenti di .NET Framework.
Tutti i parser derivati da GenericUriParser non otterranno il supporto IRI e IDN per impostazione predefinita. L'opzione Default non include il supporto IRI e IDN. Due nuovi valori vengono aggiunti all'enumerazione System.GenericUriParserOptions per indicare se un parser personalizzato supporta IRI e IDN.
Il tipo IriParsing indica che il parser supporta le regole specificate nel documento RFC 3987 per gli IRI (International Resource Identifier). L'utilizzo o meno di IRI dipende dai valori di configurazione.
Il tipo Idn indica che il parser supporta l'analisi degli IDN (Internationalized Domain Name) dei nomi host. L'utilizzo o meno di IDN dipende dai valori di configurazione.
L'impostazione di configurazione per è System.Configuration.IdnElement controllata indirettamente dall'impostazione di configurazione che controlla l'elaborazione System.Configuration.IriParsingElement IRI nella System.Uri classe . L'elaborazione degli IRI deve essere abilitata perché sia possibile elaborare gli IDN. Se l'elaborazione degli IRI è disabilitata, l'elaborazione degli IDN usa l'impostazione predefinita, basata sul comportamento di .NET Framework 2.0 per motivi di compatibilità e i nomi IDN non vengono usati.
L'attributo IDN (Internationalized Domain Name) controlla solo l'elaborazione IDN. Tutte le altre elaborazioni IRI ,ad esempio la normalizzazione dei caratteri, vengono eseguite per impostazione predefinita.
Per altre informazioni sul supporto di IRI e IDN, vedere la sezione Osservazioni per la System.Uri classe .
Prodotto | Versioni |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
.NET Standard | 2.0, 2.1 |