GenericUriParser(GenericUriParserOptions) Costruttore

Definizione

Crea un parser personalizzabile per un URI gerarchico.

public GenericUriParser (GenericUriParserOptions options);

Parametri

options
GenericUriParserOptions

Specificare le opzioni per questo oggetto GenericUriParser.

Commenti

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 .

Si applica a

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

Vedi anche