Uri.OriginalString Özellik

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Uri.cs

Oluşturucuya geçirilen özgün URI dizesini Uri alır.

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

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Özellik Değeri

String

Bu örnek oluşturulduğunda belirtilen tam URI; aksi takdirde , Empty.

Örnekler

Aşağıdaki örnek bir dizeden yeni Uri bir örnek oluşturur. Oluşturucuya geçirilen dizeyi döndüren ile dizenin OriginalStringkurallı biçimini döndüren çağrısı ToStringarasındaki farkı gösterir.

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

Açıklamalar

Oluşturucuya belirtilen URI baştaki veya sondaki boşlukları içeriyorsa, bu boşluklar korunur.

Bu özellik tarafından döndürülen değer ile AbsoluteUriarasında farklılık gösterirToString. ToString URI'nin canonically unescaped biçimini döndürür. AbsoluteUri URI'nin canonically kaçış biçimini döndürür.

Uluslararası Kaynak Tanımlayıcısı (IRI) ve Uluslararası Etki Alanı Adı (IDN) desteği etkinleştirildiğinde, OriginalString örneği başlatmak Uri için kullanılan özgün normalleştirilmiş dizeyi Punycode ana bilgisayar adıyla döndürür. Punycode adları yalnızca ASCII karakterleri içerir ve her zaman xn-- ön ekiyle başlar.

IRI desteği hakkında daha fazla bilgi için Uri sınıfın Açıklamalar bölümüne bakın.

Bir Uri nesne seri hale getirildiğinde, OriginalString korunmaz. Serileştirme işlemi, seri hale getirilirken tam olarak kaçış ve kurallı hale getirilmiş AbsoluteUri özelliği kullanır. IPv6 adresi içeren bir Uri için, IPv6 adresi ve kapsam kimliği serileştirilmiş Uri nesneye eklenir.