Freigeben über


Uri.GetComponents(UriComponents, UriFormat) Methode

Definition

Ruft die angegebenen Komponenten der aktuellen Instanz mit dem angegebenen Escapeverhalten für Sonderzeichen ab.

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

Parameter

components
UriComponents

Eine bitweise Kombination der UriComponents-Werte, die angeben, welche Teile der aktuellen Instanz dem Aufrufer zurückgegeben werden sollen.

format
UriFormat

Eine der Aufzählungswerte, die steuert, wie Sonderzeichen ausgehalten werden.

Gibt zurück

String

Die Komponenten der aktuellen Instanz.

Ausnahmen

components ist keine Kombination von gültigen UriComponents-Werten.

Der aktuelle Uri ist kein absoluter URI. Relative URIs können mit dieser Methode nicht verwendet werden.

Hinweise

Die QueryTrennzeichen , UserInfoHostPortFragmentSchemeund Path Komponenten enthalten nicht das Trennzeichen. Sie können das KeepDelimiter Flag (mit dem Bitzeiger ODER-Operator) mit einem dieser Werte kombinieren, um den Wert mit dem Trennzeichen abzurufen. Für alle anderen UriComponents Werte und Kombinationen von Werten sind die Trennzeichen im zurückgegebenen Wert enthalten.

Die Komponenten werden in der Reihenfolge zurückgegeben, in der sie im URI angezeigt werden. Wenn Scheme sie beispielsweise angegeben wird, wird sie zuerst angezeigt.

Wenn die Unterstützung für den Internationalen Ressourcenbezeichner (International Resource Identifier, IRI) und die Unterstützung für internationalisierte Domänennamen (IDN) aktiviert sind, wird die Anzahl der in den String Erhöhungen zurückgegebenen Zeichen angezeigt. Punycode-Namen, die verwendet werden, um IRI zu unterstützen, enthalten nur ASCII-Zeichen und beginnen immer mit dem xn-Präfix. Wenn IRI und IDN aktiviert sind, werden Unicode-Surrogate-Zeichen ordnungsgemäß von der GetComponents Methode behandelt.

Weitere Informationen zur Unterstützung von IRI finden Sie im Abschnitt "Hinweise" für die Uri Klasse.

Hinweis

Wenn die GetComponents Methode mit format festgelegtem Unescaped Wert aufgerufen wird, können Sie den Rückgabewert nicht als Argument für einen Uri Konstruktor verwenden, um ein gleichwertiges UriElement zu erstellen.

Gilt für