Uri.OriginalString Uri.OriginalString Uri.OriginalString Uri.OriginalString Property

Definition

Ruft die ursprüngliche URI-Zeichenfolge ab, die an den Uri-Konstruktor übergeben wurde.Gets the original URI string that was passed to the Uri constructor.

public:
 property System::String ^ OriginalString { System::String ^ get(); };
public string OriginalString { get; }
member this.OriginalString : string
Public ReadOnly Property OriginalString As String

Eigenschaftswert

Ein String, der exakt den URI enthält, der beim Erstellen dieser Instanz angegeben wurde, andernfalls Empty.A String containing the exact URI specified when this instance was constructed; otherwise, Empty.

Ausnahmen

Diese Instanz stellt einen relativen URI dar, diese Eigenschaft ist jedoch nur für absolute URIs gültig.This instance represents a relative URI, and this property is valid only for absolute URIs.

Beispiele

Das folgende Beispiel erstellt ein neues Uri Instanz aus einer Zeichenfolge.The following example creates a new Uri instance from a string. Veranschaulicht den Unterschied zwischen den Rückgabewert aus OriginalString, womit die Zeichenfolge, die übergeben wurde, an den Konstruktor, und von einem Aufruf von ToString, die die kanonische Form der Zeichenfolge zurückgibt.It illustrates the difference between the value returned from OriginalString, which returns the string that was passed to the constructor, and from a call to ToString, which returns the canonical form of the string.

// 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 orginal 
// 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 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);
    ' 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 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)

End Sub 'SampleOriginalString

Hinweise

Wenn der URI-Konstruktor angegebenen enthalten führende oder nachfolgende Leerzeichen, werden diese Leerzeichen beibehalten.If the URI specified to the constructor contained leading or trailing spaces, these spaces are preserved.

Der von dieser Eigenschaft zurückgegebene Wert unterscheidet sich von ToString und AbsoluteUri.The value returned by this property differs from ToString and AbsoluteUri. ToString die kanonisch ohne Escapezeichen Form des URI zurückgegeben.ToString returns the canonically unescaped form of the URI. AbsoluteUri Gibt die Form des URIS, die kanonisch mit Escapezeichen zurück.AbsoluteUri returns the canonically escaped form of the URI.

Wenn die Unterstützung von International Resource Identifier (IRI) und Internationalized Domain Name (IDN) aktiviert, OriginalString gibt die ursprüngliche nicht normalisierte Zeichenfolge mit Punycode-Hostnamen zurück, sofern einer, zum Initialisieren verwendet wurde der Uri Instanz.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, OriginalString returns the original non normalized string with Punycode host name if one was used to initialize the Uri instance. Punycode-Namen enthalten nur ASCII-Zeichen und beginnen immer mit dem Präfix „xn--“.Punycode names contain only ASCII characters and always start with the xn-- prefix.

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

Wenn eine Uri Objekt serialisiert wird, die OriginalString wird nicht beibehalten.When a Uri object is serialized, the OriginalString is not preserved. Der Serialisierungsprozess verwendet, die vollständig mit Escapezeichen und kanonisierte AbsoluteUri Eigenschaft bei der Serialisierung.The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. Für eine Uri , die eine IPv6-Adresse enthält, die IPv6-Adresse und die Bereichs-ID sind enthalten in der serialisierten Uri Objekt.For a Uri that contains an IPv6 address, the IPv6 address and the scope ID are included in the serialized Uri object.

Gilt für: