Uri.GetComponents(UriComponents, UriFormat) Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ArgumentOutOfRangeException

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

InvalidOperationException

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

Hinweise

Die QueryTrennzeichen , UserInfo Host Port Fragment Schemeund 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