Uri.OriginalString Uri.OriginalString Uri.OriginalString Uri.OriginalString Property

定義

Uri コンストラクターに渡された元の URI 文字列を取得します。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

プロパティ値

このインスタンスの作成時に指定した URI 自体を含む String。それ以外の場合は EmptyA String containing the exact URI specified when this instance was constructed; otherwise, Empty.

次の例では、 Uri文字列から新しいインスタンスを作成します。The following example creates a new Uri instance from a string. この例では、からOriginalString返された値の違いを示しています。これは、コンストラクターに渡された文字列を返し、をToString呼び出して、文字列の正規形式を返します。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 'SampleOriginalString

注釈

コンストラクターに指定された URI に先頭または末尾のスペースが含まれている場合、これらのスペースは保持されます。If the URI specified to the constructor contained leading or trailing spaces, these spaces are preserved.

このプロパティによって返される値ToStringAbsoluteUri、ととは異なります。The value returned by this property differs from ToString and AbsoluteUri. ToStringURI の正規エスケープされていない形式を返します。ToString returns the canonically unescaped form of the URI. AbsoluteUriURI の正規エスケープ形式を返します。AbsoluteUri returns the canonically escaped form of the URI.

国際化リソース識別子 (IRI) および国際化ドメイン名 (IDN) のサポートが有効にOriginalStringなっている場合、 Uriインスタンスを初期化するために使用された場合、は Punycode ホスト名を持つ元の正規化されていない文字列を返します。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 名には ASCII 文字のみが含まれ、常に xn-- プレフィックスで始まります。Punycode names contain only ASCII characters and always start with the xn-- prefix.

IRI サポートの詳細については、 Uriクラスの「解説」を参照してください。For more information on IRI support, see the Remarks section for the Uri class.

オブジェクトをUriシリアル化する場合OriginalString 、は保持されません。When a Uri object is serialized, the OriginalString is not preserved. シリアル化プロセスでは、シリアル化時AbsoluteUriに完全にエスケープされた正規化されたプロパティを使用します。The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. Ipv6 アドレスを含むに対しては、ipv6 アドレスとスコープ ID がシリアル化Uriされたオブジェクトに含まれます。 UriFor a Uri that contains an IPv6 address, the IPv6 address and the scope ID are included in the serialized Uri object.

適用対象