GenericUriParser(GenericUriParserOptions) Costruttore

Definizione

Crea un parser personalizzabile per un URI gerarchico.Create a customizable parser for a hierarchical URI.

public:
 GenericUriParser(GenericUriParserOptions options);
public GenericUriParser (GenericUriParserOptions options);
new GenericUriParser : GenericUriParserOptions -> GenericUriParser
Public Sub New (options As GenericUriParserOptions)

Parametri

options
GenericUriParserOptions

Specificare le opzioni per questo oggetto GenericUriParser.Specify the options for this GenericUriParser.

Commenti

Utilizzare questo costruttore come argomento perUriParser.Register(UriParser, String, Int32)Use this constructor as an argument to UriParser.Register(UriParser, String, Int32)

Se si desidera creare un parser basato su uno schema noto, utilizzare HttpStyleUriParser GopherStyleUriParser, FtpStyleUriParser LdapStyleUriParser,, o NewsStyleUriParser.If you want to create a parser based on a well-known scheme, use HttpStyleUriParser, FtpStyleUriParser, GopherStyleUriParser, LdapStyleUriParser, or NewsStyleUriParser.

Quando si crea un parser personalizzabile, il comportamento del parser viene specificato passando una combinazione bit per bit dei valori disponibili nell' System.GenericUriParserOptions enumerazione GenericUriParser al costruttore.When creating a customizable parser, the behavior of the parser is specified by passing a bitwise combination of the values available in the System.GenericUriParserOptions enumeration to the GenericUriParser constructor.

La classe System.Uri esistente è stata estesa per fornire supporto per IRI (International Resource Identifier) e i nomi di dominio internazionali (IDN).The existing System.Uri class has been extended to provide support for International Resource Identifiers (IRI) and Internationalized Domain Names (IDN). Gli utenti non noteranno alcun cambiamento dal comportamento di .NET Framework 2.0, a meno che non abilitino in modo specifico gli URI.Current users will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. Questo garantisce la compatibilità delle applicazioni con le versioni precedenti di .NET Framework.This ensures application compatibility with prior versions of the .NET Framework.

Per impostazione predefinita, tutti GenericUriParser i parser derivati da non otterranno il supporto IRI e IDN.All parsers derived from GenericUriParser will not gain IRI and IDN support by default. L' Default opzione non include il supporto di IRI e IDN.The Default option does not include IRI and IDN support. Vengono aggiunti due nuovi valori all' System.GenericUriParserOptions enumerazione per indicare se un parser personalizzato supporta IRI e IDN.Two new values are added to the System.GenericUriParserOptions enumeration to indicate if a custom parser supports IRI and IDN.

Il tipo IriParsing indica che il parser supporta le regole specificate nel documento RFC 3987 per gli IRI (International Resource Identifier).The IriParsing type indicates the parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). L'utilizzo o meno di IRI dipende dai valori di configurazione.Whether IRI is used is dictated by configuration values.

Il tipo Idn indica che il parser supporta l'analisi degli IDN (Internationalized Domain Name) dei nomi host.The Idn type indicates the parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. L'utilizzo o meno di IDN dipende dai valori di configurazione.Whether IDN is used is dictated by configuration values.

L'impostazione di configurazione per System.Configuration.IdnElement è indirettamente controllata System.Configuration.IriParsingElement dall'impostazione di configurazione che System.Uri controlla l'elaborazione IRI nella classe.The configuration setting for the System.Configuration.IdnElement is indirectly controlled by the System.Configuration.IriParsingElement configuration setting that controls IRI processing in the System.Uri class. L'elaborazione degli IRI deve essere abilitata perché sia possibile elaborare gli IDN.IRI processing must be enabled for IDN processing to be possible. 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.If IRI processing is disabled, then IDN processing will be set to the default setting where the .NET Framework 2.0 behavior is used for compatibility and IDN names are not used.

L'attributo IDN (International Domain Name) controlla solo l'elaborazione IDN.The Internationalized Domain Name (IDN) attribute only controls IDN processing. Tutte le altre operazioni di elaborazione IRI, ad esempio la normalizzazione dei caratteri, vengono eseguite per impostazione predefinita.All other IRI processing (character normalization, for example) is performed by default.

Per ulteriori informazioni sul supporto di IRI e IDN, vedere la sezione Osservazioni relativa System.Uri alla classe.For more information on IRI and IDN support, see the Remarks section for the System.Uri class.

Si applica a

Vedi anche