GenericUriParser(GenericUriParserOptions) Конструктор

Определение

Создает настраиваемый анализатор иерархического универсального кода ресурса (URI).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)

Параметры

options
GenericUriParserOptions

Укажите параметры для этого GenericUriParser.Specify the options for this GenericUriParser.

Комментарии

Используйте этот конструктор в качестве аргумента дляUriParser.Register(UriParser, String, Int32)Use this constructor as an argument to UriParser.Register(UriParser, String, Int32)

Если необходимо создать средство синтаксического анализа на основе хорошо известной схемы, используйте,, HttpStyleUriParser , FtpStyleUriParser GopherStyleUriParser LdapStyleUriParser или NewsStyleUriParser .If you want to create a parser based on a well-known scheme, use HttpStyleUriParser, FtpStyleUriParser, GopherStyleUriParser, LdapStyleUriParser, or NewsStyleUriParser.

При создании настраиваемого средства синтаксического анализа поведение средства синтаксического анализа задается путем передачи побитового сочетания значений, доступных в System.GenericUriParserOptions перечислении, в GenericUriParser конструктор.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.

Существующий System.Uri класс был расширен для предоставления поддержки международных идентификаторов ресурсов (IRI) и международных доменных имен (IDN).The existing System.Uri class has been extended to provide support for International Resource Identifiers (IRI) and Internationalized Domain Names (IDN). Пользователи не увидят никаких функциональных изменений, внесенных после платформы .NET Framework 2.0, пока специально не включат поддержку IRI.Current users will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. Это обеспечивает совместимость приложений с предыдущими версиями платформы .NET Framework.This ensures application compatibility with prior versions of the .NET Framework.

Все парсеры, производные от GenericUriParser , не будут получать поддержку IRI и IDN по умолчанию.All parsers derived from GenericUriParser will not gain IRI and IDN support by default. DefaultПараметр не включает поддержку IRI и IDN.The Default option does not include IRI and IDN support. В перечисление добавляются два новых значения, System.GenericUriParserOptions которые указывают, поддерживает ли пользовательское средство синтаксического анализа IRI и IDN.Two new values are added to the System.GenericUriParserOptions enumeration to indicate if a custom parser supports IRI and IDN.

Тип IriParsing указывает на то, что средство синтаксического анализа поддерживает правила анализа, определенные стандартом RFC 3987 для международных кодов ресурсов (IRI).The IriParsing type indicates the parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). Используются ли IRI, зависит от значений параметров конфигурации.Whether IRI is used is dictated by configuration values.

Тип Idn указывает на то, что средство синтаксического анализа поддерживает анализ международных доменных имен (IDN) узлов.The Idn type indicates the parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Используются ли IDN, зависит от значений параметров конфигурации.Whether IDN is used is dictated by configuration values.

Параметр конфигурации для элемента System.Configuration.IdnElement косвенно контролируется System.Configuration.IriParsingElement параметром конфигурации, который управляет обработкой IRI в System.Uri классе.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. Обработка IRI должна быть включена для обработки IDN.IRI processing must be enabled for IDN processing to be possible. Если IRI-система не включена, то обработка IDN данных будет происходить по умолчанию, когда режим платформы .NET Framework 2.0 является совместимым и имена IDN не используются.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.

Атрибут международного доменного имени (IDN) управляет обработкой IDN.The Internationalized Domain Name (IDN) attribute only controls IDN processing. Вся остальная обработка IRI (например, нормализация символов) выполняется по умолчанию.All other IRI processing (character normalization, for example) is performed by default.

Дополнительные сведения о поддержке IRI и IDN см. в разделе "Примечания" для System.Uri класса.For more information on IRI and IDN support, see the Remarks section for the System.Uri class.

Применяется к

См. также раздел