Uri.OriginalString Eigenschaft

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

Uri.cs

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

public:
 property System::String ^ OriginalString { System::String ^ get(); };

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Eigenschaftswert

String

Der genaue URI, der angegeben wurde, als dieser instance erstellt wurde, Emptyandernfalls .

Beispiele

Im folgenden Beispiel wird eine neue Uri instance aus einer Zeichenfolge erstellt. Es veranschaulicht den Unterschied zwischen dem Wert, der von OriginalStringzurückgegeben wird, der die Zeichenfolge zurückgibt, die an den Konstruktor übergeben wurde, und einem Aufruf ToStringvon , der die kanonische Form der Zeichenfolge zurückgibt.

// Create a new Uri from a string address.
Uri^ uriAddress = gcnew 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 original 
// string that was passed to the constructor.
// The following outputs "http://www.contoso.com//thick and thin.htm".
Console::WriteLine( uriAddress );

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

// 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 original
// 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);

// Create a new Uri from a string address.
let uriAddress = 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 original
// string that was passed to the constructor.

// The following outputs "http://www.contoso.com//thick and thin.htm".
printfn $"{uriAddress.ToString()}"

// The following outputs "HTTP://www.ConToso.com:80//thick%20and%20thin.htm".
printfn $"{uriAddress.OriginalString}"

    ' Create a new Uri from a string address.
    Dim uriAddress As 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 original 
    ' 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)

End Sub

Hinweise

Wenn der für den Konstruktor angegebene URI führende oder nachfolgende Leerzeichen enthält, werden diese Leerzeichen beibehalten.

Der von dieser Eigenschaft zurückgegebene Wert unterscheidet sich von ToString und AbsoluteUri. ToString gibt die kanonisch nicht gescapete Form des URI zurück. AbsoluteUri gibt die kanonisch mit Escapezeichen versehene Form des URI zurück.

Wenn die Unterstützung für International Resource Identifier (IRI) und Internationalized Domain Name (IDN) aktiviert ist, OriginalString wird die ursprüngliche nicht normalisierte Zeichenfolge mit dem Hostnamen Punycode zurückgegeben, sofern eins zum Initialisieren der Uri instance verwendet wurde. Punycode-Namen enthalten nur ASCII-Zeichen und beginnen immer mit dem Präfix „xn--“.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt Hinweise für die Uri Klasse.

Wenn ein Uri Objekt serialisiert wird, wird die OriginalString nicht beibehalten. Der Serialisierungsprozess verwendet beim Serialisieren die vollständig mit Escapezeichen versehene und kanonische AbsoluteUri Eigenschaft. Bei einer Uri , die eine IPv6-Adresse enthält, werden die IPv6-Adresse und die Bereichs-ID im serialisierten Uri Objekt enthalten.