Бөлісу құралы:


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

Определение

Получает заданные компоненты текущего экземпляра, используя указанное для специальных знаков 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

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

Исключения

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

Текущий 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.

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