Uri.OriginalString 속성

정의

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

속성 값

String

The exact URI specified when this instance was constructed; otherwise, <see cref="F:System.String.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 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.
    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

설명

생성자에 지정 된 URI에 선행 또는 후행 공백이 포함 된 경우 이러한 공백은 유지 됩니다.If the URI specified to the constructor contained leading or trailing spaces, these spaces are preserved.

이 속성에서 반환 되는 값은 ToString 및와 다릅니다 AbsoluteUri .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.

IRI (국제 리소스 식별자) 및 IDN (다국어 도메인 이름) 지원을 사용 하는 경우 OriginalString 인스턴스를 초기화 하는 데 사용 된 경우는 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개체가 serialize 될 때는 OriginalString 유지 되지 않습니다.When a Uri object is serialized, the OriginalString is not preserved. Serialization 프로세스는 serialize 할 때 완전히 이스케이프 되 고 정형화 된 속성을 사용 합니다 AbsoluteUri .The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. UriIpv6 주소가 포함 된의 경우 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.

적용 대상