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

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

UriExt.cs

Возвращает указанные компоненты текущего экземпляра с помощью указанного экранирования для специальных символов.

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). Относительные URI нельзя использовать с этим методом.

Комментарии

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

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

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

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

Note

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