(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Uri.GetComponents-Methode

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

Namespace:  System
Assembly:  System (in System.dll)

public string GetComponents(
	UriComponents components,
	UriFormat format
)

Parameter

components
Typ: System.UriComponents
Eine bitweise Kombination der UriComponents-Werte, die angeben, welche Teile der aktuellen Instanz dem Aufrufer zurückgegeben werden sollen.
format
Typ: System.UriFormat
Einer der UriFormat-Werte, die steuern, wie Sonderzeichen mit Escapezeichen versehen werden.

Rückgabewert

Typ: System.String
Ein String, der die Komponenten enthält.

AusnahmeBedingung
ArgumentOutOfRangeException

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

Wenn Query oder Fragment allein angegeben wird, schließt der Rückgabewert das Trennzeichen ein. Die Komponenten Scheme, UserInfo, Host, Port und Path schließen das Trennzeichen nicht ein. 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 z. B. Scheme angegeben wird, wird es zuerst angezeigt.

Wenn die Unterstützung von IRI (International Resource Identifier) und IDN (Internationalized Domain Name) aktiviert ist, vergrößert sich die Anzahl der im String zurückgegebenen Zeichen. Punycode-Namen, mit denen IRI unterstützt wird, enthalten nur ASCII-Zeichen und beginnen immer mit dem Präfix xn--. 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 die Uri-Klasse.

HinweisHinweis

Wenn die GetComponents-Methode aufgerufen wird und format auf Unescaped festgelegt ist, können Sie den Rückgabewert nicht als Argument für einen Uri-Konstruktor verwenden, um einen äquivalenten Uri zu erstellen.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft