Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Uri.OriginalString-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft die ursprüngliche URI-Zeichenfolge ab, die an den Uri-Konstruktor übergeben wurde.

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

public string OriginalString { get; }

Eigenschaftswert

Type: System.String

Ein String, der exakt den URI enthält, der beim Erstellen dieser Instanz angegeben wurde, andernfalls Empty.

Exception Condition
InvalidOperationException

Diese Instanz einen relativen URI darstellt, und diese Eigenschaft gilt nur für absolute URIs handelt.

Wenn an den Konstruktor angegebene URI enthalten führenden oder nachgestellten Leerzeichen enthalten, werden diese Leerzeichen beibehalten.

Der von dieser Eigenschaft zurückgegebene Wert unterscheidet sich von ToString und AbsoluteUri. ToStringGibt den URI kanonisch ohne Escapezeichen Form zurück. AbsoluteUriGibt die Form des URIS, die kanonisch mit Escapezeichen zurück.

Wenn die Unterstützung von International Resource Identifier (IRI) und Internationalized Domain Name (IDN) aktiviert ist, OriginalString gibt die ursprüngliche, nicht normalisierte Zeichenfolge mit Punycode-Hostnamen zurück, sofern einer, zum Initialisieren verwendet wurde der Uri Instanz. Punycode-Namen nur ASCII-Zeichen enthalten und beginnen immer mit dem Präfix Xn--.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" der Uri Klasse.

Wenn eine Uri Objekt serialisiert wird, die OriginalString wird nicht beibehalten. Der Serialisierungsprozess verwendet, die vollständig mit Escapezeichen versehene und kanonisierte AbsoluteUri Eigenschaft bei der Serialisierung. Für eine Uri , eine IPv6-Adresse enthält, wird die IPv6-Adresse und die Bereichs-ID sind enthalten in der serialisierten Uri Objekt.

Das folgende Beispiel erstellt ein neues Uri Instanz aus einer Zeichenfolge. Veranschaulicht den Unterschied zwischen den Rückgabewert aus OriginalString, womit die Zeichenfolge, die übergeben wurde, an den Konstruktor und Aufrufen von ToString, die die kanonische Form der Zeichenfolge zurückgibt.

// Create a new Uri from a string address.
Uri uriAddress = new Uri("HTTP://www.ConToso.com:80//thick%20and%20thin.htm");

// Write the new Uri to the console and note the difference in the two values.
// ToString() gives the canonical version.  OriginalString gives the orginal 
// string that was passed to the constructor.

// The following outputs "http://www.contoso.com/thick and thin.htm".
Console.WriteLine(uriAddress.ToString()); 

// The following outputs "HTTP://www.ConToso.com:80//thick%20and%20thin.htm".
Console.WriteLine(uriAddress.OriginalString);

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 2.0
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: