Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Method

Definition

Ruft die angegebenen Komponenten der aktuellen Instanz mit dem angegebenen Escapeverhalten für Sonderzeichen ab.Gets the specified components of the current instance using the specified escaping for special characters.

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

Eine bitweise Kombination der UriComponents-Werte, die angeben, welche Teile der aktuellen Instanz dem Aufrufer zurückgegeben werden sollen.A bitwise combination of the UriComponents values that specifies which parts of the current instance to return to the caller.

format
UriFormat UriFormat UriFormat UriFormat

Einer der UriFormat-Werte, die steuern, wie Sonderzeichen mit Escapezeichen versehen werden.One of the UriFormat values that controls how special characters are escaped.

Gibt zurück

Ein String, der die Komponenten enthält.A String that contains the components.

Ausnahmen

components ist keine Kombination von gültigen UriComponents-Werten.components is not a combination of valid UriComponents values.

Der aktuelle Uri ist kein absoluter URI.The current Uri is not an absolute URI. Relative URIs können mit dieser Methode nicht verwendet werden.Relative URIs cannot be used with this method.

Hinweise

Die Query- Fragment ,UserInfo -,Path -,- ,Port-,-und-Komponenten enthalten das Trennzeichen nicht. Host SchemeThe Query, Fragment, Scheme, UserInfo, Host, Port, and Path components do not include the delimiter. Sie können das KeepDelimiter -Flag (mit dem bitweisen OR-Operator) mit einem dieser Werte kombinieren, um den Wert mit dem Trennzeichen zu erhalten.You can combine the KeepDelimiter flag (using the bitwise OR operator) with any of those values to get the value with the delimiter. Für alle anderen UriComponents Werte und Kombinationen von Werten sind die Trennzeichen im zurückgegebenen Wert enthalten.For all other UriComponents values, and combinations of values, the delimiters are included in the returned value.

Die Komponenten werden in der Reihenfolge zurückgegeben, in der Sie im URI angezeigt werden.The components are returned in the order that they appear in the URI. Wenn Scheme z. b. angegeben ist, wird es zuerst angezeigt.For example, if Scheme is specified, it appears first.

Wenn die Unterstützung für internationale Ressourcen Bezeichner (IRI) und internationalisierte Domänen Namen (IDN) aktiviert ist, erhöht sich String die Anzahl der in der zurückgegebenen Zeichen.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, the number of characters returned in the String increases. Punycode-Namen, die zur Unterstützung von IRI verwendet werden, enthalten nur ASCII-Zeichen und beginnen immer mit dem XN--Präfix.Punycode names used to support IRI contain only ASCII characters and always start with the xn-- prefix. Wenn IRI und IDN aktiviert sind, werden Unicode-Ersatz Zeichen von der GetComponents -Methode ordnungsgemäß behandelt.When IRI and IDN are enabled, Unicode surrogate characters are handled correctly by the GetComponents method.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise Uri " für die-Klasse.For more information on IRI support, see the Remarks section for the Uri class.

Hinweis

Wenn die GetComponents -Methode format aufgerufen wird und auf Unescaped festgelegt ist, können Sie den Rückgabewert nicht als Argument Uri für einen Konstruktor verwenden, Urium eine Entsprechung zu erstellen.If the GetComponents method is called with format set to Unescaped , you cannot use the return value as an argument to a Uri constructor to create an equivalent Uri.

Gilt für: