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 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
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.