Uri.OriginalString Tulajdonság

Definíció

Névtér:

System

Szerelvény:

System.dll

Lekéri a konstruktornak Uri átadott eredeti URI-sztringet.

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

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Tulajdonság értéke

String

A példány létrehozásakor megadott pontos URI; egyéb esetben. Empty

Példák

Az alábbi példa egy új Uri példányt hoz létre egy sztringből. A függvény a konstruktornak átadott sztringet OriginalStringvisszaadó érték és a meghívás ToStringközötti különbséget mutatja be, amely a sztring canonikus formáját adja vissza.

// 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

Megjegyzések

Ha a konstruktornak megadott URI kezdő vagy záró szóközöket tartalmaz, ezek a szóközök megmaradnak.

A tulajdonság által visszaadott érték eltér az és AbsoluteUria ToString . ToString az URI vessző nélküli formáját adja vissza. AbsoluteUri az URI canonikusan megmenekült formáját adja vissza.

Ha a nemzetközi erőforrás-azonosító (IRI) és az internationalized domain name (IDN) támogatás engedélyezve van, OriginalString az eredeti nem normalizált sztringet adja vissza a Punycode gazdagép nevével, ha a Uri példány inicializálásához használták. A punycode nevek csak ASCII karaktereket tartalmaznak, és mindig az xn előtaggal kezdődnek.

Az IRI támogatásával kapcsolatos további információkért tekintse meg az osztály Megjegyzések szakaszát Uri .

Ha egy Uri objektum szerializálva van, az OriginalString nem marad meg. A szerializálási folyamat a szerializálás során a teljesen kimenekített és a canonicalizált tulajdonságot AbsoluteUri használja. Uri Az IPv6-címet tartalmazó objektumok esetében az IPv6-cím és a hatókör-azonosító szerepel a szerializált Uri objektumban.