Uri.OriginalString Egenskap

Definition

Namnområde:

System

Sammansättning:

System.dll

Hämtar den ursprungliga URI-strängen Uri som skickades till konstruktorn.

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

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Egenskapsvärde

String

Den exakta URI som angavs när den här instansen skapades. annars . Empty

Exempel

I följande exempel skapas en ny Uri instans från en sträng. Den illustrerar skillnaden mellan det värde som returneras från OriginalString, som returnerar strängen som skickades till konstruktorn och från ett anrop till ToString, som returnerar strängens kanoniska form.

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

Kommentarer

Om den URI som angetts för konstruktorn innehöll inledande eller avslutande blanksteg bevaras dessa blanksteg.

Värdet som returneras av den här egenskapen skiljer sig från ToString och AbsoluteUri. ToString returnerar den kanoniskt ej kapslade formen av URI:n. AbsoluteUri returnerar URI:ns kanoniskt undantagna form.

När stöd för internationell resursidentifierare (IRI) och internationaliserat domännamn (IDN) är aktiverat OriginalString returnerar den ursprungliga icke-normaliserade strängen med Punycode-värdnamnet om en användes för att initiera instansen Uri . Punycode-namn innehåller bara ASCII-tecken och börjar alltid med prefixet xn.

Mer information om IRI-stöd finns i avsnittet Anmärkningar för Uri klassen.

När ett Uri objekt serialiseras OriginalString bevaras inte. Serialiseringsprocessen använder den fullständigt undantagna och kanoniserade AbsoluteUri egenskapen vid serialisering. För en Uri som innehåller en IPv6-adress inkluderas IPv6-adressen och omfångs-ID:t i det serialiserade Uri objektet.