Uri.GetComponents(UriComponents, UriFormat) Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Получает заданные компоненты текущего экземпляра, используя указанное для специальных знаков escape-преобразование.

public:
 System::String ^ GetComponents(UriComponents components, UriFormat format);

public string GetComponents (UriComponents components, UriFormat format);

member this.GetComponents : UriComponents * UriFormat -> string

Public Function GetComponents (components As UriComponents, format As UriFormat) As String

Параметры

components

UriComponents

Побитовое сочетание значений UriComponents, позволяющее определить, какие части текущего экземпляра будут возвращены вызывающему оператору.

format

UriFormat

Одно из значений перечисления для управления способом экранирования специальных символов.

Возвращаемое значение

String

Компоненты текущего экземпляра.

Исключения

ArgumentOutOfRangeException

Параметр components не является сочетанием допустимых значений UriComponents.

InvalidOperationException

Текущий Uri не является абсолютным URI. Относительные URI в этом методе использовать нельзя.

Комментарии

Компоненты Query, , , Fragmentа HostPortSchemeUserInfoPath также не включают разделитель. Вы можете объединить KeepDelimiter флаг (с помощью побитового оператора OR) с любым из этих значений, чтобы получить значение с разделителем. Для всех остальных UriComponents значений и сочетаний значений разделители включаются в возвращаемое значение.

Компоненты возвращаются в том порядке, в который они отображаются в URI. Например, если Scheme он указан, сначала он отображается.

Если включена поддержка международного идентификатора ресурса (IRI) и международного доменного имени (IDN), количество символов, возвращаемых в String увеличении. Имена Punycode, используемые для поддержки IRI, содержат только символы ASCII и всегда начинаются с префикса xn-- . Если IRI и IDN включены, суррогатные символы Юникода обрабатываются методом GetComponents правильно.

Дополнительные сведения о поддержке IRI см. в разделе "Примечания" для Uri класса.

Примечание

GetComponents Если метод вызывается с format заданным Unescaped значением, возвращаемое значение нельзя использовать в качестве аргумента Uri конструктору для создания эквивалентаUri.