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.

Beispiele

Im folgenden Beispiel wird eine neue Uri -Instanz aus einer Zeichenfolge erstellt.The following example creates a new Uri instance from a string. Es veranschaulicht den Unterschied zwischen dem Wert, OriginalStringder von zurückgegeben wird, der die Zeichenfolge zurückgibt, die an den Konstruktor ToStringübergeben wurde, und von einem-Befehl, der 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

Hinweise

Wenn der URI, der für den Konstruktor angegeben wurde, führende oder nachfolgende Leerzeichen enthält, 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 unter ToString scheidet AbsoluteUrisich von und.The value returned by this property differs from ToString and AbsoluteUri. ToStringGibt die kanonisch ohne Escapezeichen für den URI zurück.ToString returns the canonically unescaped form of the URI. AbsoluteUriGibt die kanonisch geschützte Form des URIs zurück.AbsoluteUri returns the canonically escaped form of the URI.

Wenn die Unterstützung internationaler Ressourcen Bezeichner (IRI) und Internationalized Domain Name (IDN) OriginalString aktiviert ist, wird die ursprüngliche nicht normalisierte Zeichenfolge mit dem Punycode-Hostnamen zurückgegeben Uri , wenn zum Initialisieren der Instanz verwendet wurde.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 Uri " für die-Klasse.For more information on IRI support, see the Remarks section for the Uri class.

Wenn ein Uri -Objekt serialisiert wird, OriginalString wird der nicht beibehalten.When a Uri object is serialized, the OriginalString is not preserved. Der Serialisierungsprozess verwendet bei der Serialisierung die AbsoluteUri vollständig mit Escapezeichen und kanonisierte Eigenschaft.The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. Bei einem Uri -Objekt, das eine IPv6-Adresse enthält, sind die IPv6-Adresse und die Bereichs- Uri ID im serialisierten Objekt enthalten.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: