Uri.OriginalString Vlastnost

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

Uri.cs

Získá původní řetězec identifikátoru URI, který byl předán konstruktoru Uri .

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

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Hodnota vlastnosti

String

Přesný identifikátor URI zadaný při vytvoření této instance; v opačném případě . Empty

Příklady

Následující příklad vytvoří novou Uri instanci z řetězce. Znázorňuje rozdíl mezi hodnotou vrácenou z OriginalString, která vrací řetězec, který byl předán konstruktoru, a z volání ToString, které vrací kanonický tvar řetězce.

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

Poznámky

Pokud identifikátor URI zadaný konstruktoru obsahoval úvodní nebo koncové mezery, tyto mezery se zachovají.

Hodnota vrácená touto vlastností se liší od ToString hodnot a AbsoluteUri. ToString vrátí kanonicky neuskutečněnou formu identifikátoru URI. AbsoluteUri vrátí kanonicky uváděnou formu identifikátoru URI.

Pokud je povolena OriginalString podpora international resource identifier (IRI) a internationalizovaného názvu domény (IDN), vrátí se původní nenormalizovaný řetězec s názvem hostitele Punycode, pokud byl použit k inicializaci Uri instance. Punycode názvy obsahují pouze znaky ASCII a vždy začínají předponou xn--.

Další informace o podpoře IRI najdete v části Poznámky pro třídu Uri .

Uri Při serializaci objektu OriginalString se nezachová. Proces serializace používá plně řídicí a kanonizované AbsoluteUri vlastnost při serializaci. U objektu, Uri který obsahuje adresu IPv6, jsou adresa IPv6 a ID oboru zahrnuty v serializovaném Uri objektu.