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 を表します。このプロパティは、絶対 URI でのみ有効です。This instance represents a relative URI, and this property is valid only for absolute URIs.

次の例では、作成、新しい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. ToString URI のエスケープ解除された正規の形式を返します。ToString returns the canonically unescaped form of the URI. AbsoluteUri URI のエスケープされた正規の形式を返します。AbsoluteUri returns the canonically escaped form of the URI.

International Resource Identifier (IRI) および国際化ドメイン名 (IDN) のサポートを有効にすると、 OriginalString 1 つを初期化するために使用した場合のホスト名を Punycode に元の非正規化された文字列を返します、Uriインスタンス。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. Uri IPv6 アドレスを格納している、IPv6 アドレスとスコープ ID が含まれています、シリアル化されたでUriオブジェクト。For a Uri that contains an IPv6 address, the IPv6 address and the scope ID are included in the serialized Uri object.

適用対象