Uri.GetComponents(UriComponents, UriFormat) Methode
Definition
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 mithilfe der angegebenen Escapezeichen für Sonderzeichen ab.
public:
System::String ^ GetComponents(UriComponents components, UriFormat format);public string GetComponents(UriComponents components, UriFormat format);member this.GetComponents : UriComponents * UriFormat -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParameter
- components
- UriComponents
Eine bitweise Kombination der UriComponents Werte, die angibt, welche Teile der aktuellen Instanz an den Aufrufer zurückgegeben werden sollen.
- format
- UriFormat
Einer der Enumerationswerte, mit denen gesteuert wird, wie Sonderzeichen mit Escapezeichen versehen werden.
Gibt zurück
Die Komponenten der aktuellen Instanz.
Ausnahmen
components ist keine Kombination gültiger UriComponents Werte.
Der aktuelle Uri URI ist kein absoluter URI. Relative URIs können mit dieser Methode nicht verwendet werden.
Hinweise
Die Query, Fragment, Scheme, UserInfo, Host, , Portund Path Komponenten enthalten nicht das Trennzeichen. Sie können das KeepDelimiter Flag (mit dem bitweisen OR-Operator) mit einem dieser Werte kombinieren, um den Wert mit dem Trennzeichen abzurufen. Für alle anderen UriComponents Werte und Kombinationen von Werten werden die Trennzeichen in den zurückgegebenen Wert eingeschlossen.
Die Komponenten werden in der Reihenfolge zurückgegeben, in der sie im URI angezeigt werden. Wenn beispielsweise Scheme angegeben wird, wird sie zuerst angezeigt.
Wenn die Unterstützung von International Resource Identifier (IRI) und Internationalized Domain Name (IDN) aktiviert ist, erhöht sich die Anzahl der in den String Zahlen zurückgegebenen Zeichen. 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-Ersatzzeichen von der GetComponents Methode ordnungsgemäß behandelt.
Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" für den Uri Kurs.
Note
Wenn die GetComponents Methode mit format set auf Unescaped aufgerufen wird, können Sie den Rückgabewert nicht als Argument für einen Uri Konstruktor verwenden, um eine entsprechung Urizu erstellen.
