Uri 생성자

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

Uri 클래스의 새 인스턴스를 초기화합니다.

오버로드

Uri(String)	지정된 URI를 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(SerializationInfo, StreamingContext)	사용되지 않음. SerializationInfo 및 StreamingContext 클래스의 지정된 인스턴스에서 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(String, Boolean)	사용되지 않음. 문자 이스케이프를 명시적으로 제어하여 지정된 URI를 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(String, UriCreationOptions)	지정된 URI 및 추가 UriCreationOptions사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(String, UriKind)	지정된 URI를 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다. 이 생성자를 사용하면 URI 문자열이 상대 URI, 절대 URI 또는 확정되지 않은지 여부를 지정할 수 있습니다.
Uri(Uri, String)	지정된 기본 URI 및 상대 URI 문자열을 기반으로 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(Uri, Uri)	지정된 기본 Uri 인스턴스와 상대 Uri 인스턴스의 조합에 따라 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(Uri, String, Boolean)	사용되지 않음. 문자 이스케이프를 명시적으로 제어하여 지정된 기본 및 상대 URI를 기반으로 Uri 클래스의 새 인스턴스를 초기화합니다.

Uri(String)

Source:

Uri.cs

지정된 URI를 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.

public:
 Uri(System::String ^ uriString);

public Uri (string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

매개 변수

uriString

String

Uri 인스턴스가 나타낼 리소스를 식별하는 문자열입니다. 문자열 형식의 IPv6 주소는 대괄호 안에 묶어야 합니다. 예를 들어 "http://[2607:f8b0:400d:c06::69]"입니다.

예외

ArgumentNullException

uriString null.

UriFormatException

참고: windows 스토어 앱 또는 이식 가능한 클래스 라이브러리.NET에서 기본 클래스 예외인 대신 catch합니다.

uriString 비어 있습니다.

-또는-

uriString 지정된 체계가 올바르게 구성되지 않았습니다. CheckSchemeName(String)참조하세요.

-또는-

uriString 슬래시가 너무 많습니다.

-또는-

uriString 지정된 암호가 잘못되었습니다.

-또는-

uriString 지정된 호스트 이름이 잘못되었습니다.

-또는-

uriString 지정된 파일 이름이 잘못되었습니다.

-또는-

uriString 지정된 사용자 이름이 잘못되었습니다.

-또는-

uriString 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

uriString 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

uriString 길이가 65519자를 초과합니다.

-또는-

uriString 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

uriString잘못된 문자 시퀀스가 있습니다.

-또는-

uriString 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

예제

다음 예제에서는 URI http://www.contoso.com/사용하여 Uri 인스턴스를 만듭니다.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );

Uri myUri = new Uri("http://www.contoso.com/");

let myUri = Uri "http://www.contoso.com/"

Dim myUri As New Uri("http://www.contoso.com/")

설명

이 생성자는 URI 문자열에서 Uri 인스턴스를 만듭니다. URI를 구문 분석하고 정식 형식으로 배치하며 필요한 이스케이프 인코딩을 만듭니다.

이 생성자는 Uri 액세스 가능한 리소스를 참조하도록 보장하지 않습니다.

이 생성자는 string 매개 변수가 절대 URI를 참조하고 AbsoluteUriKind 설정된 Uri 생성자를 호출하는 것과 같다고 가정합니다. 생성자에 전달된 string 매개 변수가 상대 URI인 경우 이 생성자는 UriFormatExceptionthrow합니다.

Uri(SerializationInfo, StreamingContext)

Source:

Uri.cs

주의

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

SerializationInfo 및 StreamingContext 클래스의 지정된 인스턴스에서 Uri 클래스의 새 인스턴스를 초기화합니다.

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

매개 변수

serializationInfo

SerializationInfo

새 Uri 인스턴스를 serialize하는 데 필요한 정보를 포함하는 SerializationInfo 클래스의 인스턴스입니다.

streamingContext

StreamingContext

새 Uri 인스턴스와 연결된 직렬화된 스트림의 원본을 포함하는 StreamingContext 클래스의 인스턴스입니다.

특성

ObsoleteAttribute

예외

ArgumentNullException

serializationInfo 매개 변수에는 null URI가 포함되어 있습니다.

UriFormatException

serializationInfo 매개 변수에는 비어 있는 URI가 포함되어 있습니다.

-또는-

지정한 체계가 올바르게 구성되지 않았습니다. CheckSchemeName(String)참조하세요.

-또는-

URI에 너무 많은 슬래시가 포함되어 있습니다.

-또는-

URI에 지정된 암호가 잘못되었습니다.

-또는-

URI에 지정된 호스트 이름이 잘못되었습니다.

-또는-

URI에 지정된 파일 이름이 잘못되었습니다.

-또는-

URI에 지정된 사용자 이름이 잘못되었습니다.

-또는-

URI에 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

URI에 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

URI 길이가 65519자를 초과합니다.

-또는-

URI에 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

URI에 잘못된 문자 시퀀스가 있습니다.

-또는-

URI에 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

설명

이 생성자는 Uri 클래스에 대한 ISerializable 인터페이스를 구현합니다.

추가 정보

• XML 및 SOAP Serialization

Uri(String, Boolean)

Source:

Uri.cs

주의

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.

문자 이스케이프를 명시적으로 제어하여 지정된 URI를 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.

public:
 Uri(System::String ^ uriString, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri (string uriString, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

Public Sub New (uriString As String, dontEscape As Boolean)

매개 변수

uriString

String

Uri 인스턴스가 나타낼 리소스를 식별하는 문자열입니다. 문자열 형식의 IPv6 주소는 대괄호 안에 묶어야 합니다. 예를 들어 "http://[2607:f8b0:400d:c06::69]"입니다.

dontEscape

Boolean

uriString 완전히 이스케이프되었는지 true. 그렇지 않으면 false.

특성

ObsoleteAttribute

예외

ArgumentNullException

uriString null.

UriFormatException

uriString 비어 있거나 공백만 포함합니다.

-또는-

uriString 지정된 체계가 잘못되었습니다.

-또는-

uriString 슬래시가 너무 많습니다.

-또는-

uriString 지정된 암호가 잘못되었습니다.

-또는-

uriString 지정된 호스트 이름이 잘못되었습니다.

-또는-

uriString 지정된 파일 이름이 잘못되었습니다.

-또는-

uriString 지정된 사용자 이름이 잘못되었습니다.

-또는-

uriString 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

uriString 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

uriString 길이가 65519자를 초과합니다.

-또는-

uriString 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

uriString잘못된 문자 시퀀스가 있습니다.

-또는-

uriString 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

예제

다음 예제에서는 URI http://www.contoso.com/Hello%20World.htm대한 Uri 인스턴스를 만듭니다. 포함된 URI는 완전히 이스케이프되고 정식 형식이므로 dontEscape 매개 변수를 true설정할 수 있습니다.

Uri^ myUri = gcnew Uri(  "http://www.contoso.com/Hello%20World.htm",true );

Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

let myUri = Uri("http://www.contoso.com/Hello%20World.htm", true)

Dim myUri As New Uri("http://www.contoso.com/Hello%20World.htm", True)

설명

이 생성자는 URI 문자열에서 Uri 인스턴스를 만듭니다. URI를 구문 분석하고 정식 형식으로 배치합니다.

dontEscape 매개 변수는 예약된 문자가 이스케이프 시퀀스로 변환되는지 여부를 제어합니다. 이 매개 변수는 URI의 모든 예약 문자가 이스케이프된 것으로 확신하는 경우에만 true 설정해야 합니다. 완전히 이스케이프되지 않은 URI의 값을 true 설정하면 예기치 않은 동작이 발생할 수 있습니다. 항상 이 매개 변수를 false설정하는 것이 좋습니다.

dontEscape false설정된 경우 생성자는 모든 발생률(%)이 유효한 이스케이프 시퀀스 뒤에 있는지 확인하여 예약된 문자를 이스케이프합니다. 백분율을 따르는 문자 시퀀스가 유효하지 않으면 백분율이 %25대체됩니다.

이 생성자는 Uri 액세스 가능한 리소스를 참조하도록 보장하지 않습니다.

Uri(String, UriCreationOptions)

Source:

Uri.cs

지정된 URI 및 추가 UriCreationOptions사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);

public Uri (string uriString, in UriCreationOptions creationOptions);

new Uri : string * UriCreationOptions -> Uri

Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

매개 변수

uriString

String

Uri 인스턴스가 나타낼 리소스를 식별하는 문자열입니다.

creationOptions

UriCreationOptions

Uri 만들고 동작하는 방법을 제어하는 옵션입니다.

Uri(String, UriKind)

Source:

Uri.cs

지정된 URI를 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다. 이 생성자를 사용하면 URI 문자열이 상대 URI, 절대 URI 또는 확정되지 않은지 여부를 지정할 수 있습니다.

public:
 Uri(System::String ^ uriString, UriKind uriKind);

public Uri (string uriString, UriKind uriKind);

new Uri : string * UriKind -> Uri

Public Sub New (uriString As String, uriKind As UriKind)

매개 변수

uriString

String

Uri 인스턴스가 나타낼 리소스를 식별하는 문자열입니다. 문자열 형식의 IPv6 주소는 대괄호 안에 묶어야 합니다. 예를 들어 "http://[2607:f8b0:400d:c06::69]"입니다.

uriKind

UriKind

URI 문자열이 상대 URI, 절대 URI인지, 아니면 확정되지 않았는지를 지정합니다.

예외

ArgumentException

uriKind 잘못되었습니다.

ArgumentNullException

uriString null.

UriFormatException

참고: windows 스토어 앱 또는 이식 가능한 클래스 라이브러리.NET에서 기본 클래스 예외인 대신 catch합니다.

uriString 상대 URI를 포함하고 uriKindAbsolute.

또는

uriString 절대 URI를 포함하고 uriKindRelative.

또는

uriString 비어 있습니다.

-또는-

uriString 지정된 체계가 올바르게 구성되지 않았습니다. CheckSchemeName(String)참조하세요.

-또는-

uriString 슬래시가 너무 많습니다.

-또는-

uriString 지정된 암호가 잘못되었습니다.

-또는-

uriString 지정된 호스트 이름이 잘못되었습니다.

-또는-

uriString 지정된 파일 이름이 잘못되었습니다.

-또는-

uriString 지정된 사용자 이름이 잘못되었습니다.

-또는-

uriString 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

uriString 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

uriString 길이가 65519자를 초과합니다.

-또는-

uriString 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

uriString잘못된 문자 시퀀스가 있습니다.

-또는-

uriString 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

설명

상대 URI와 절대 URI의 형식에 대한 제한 사항이 다릅니다. 예를 들어 상대 URI에는 체계나 권한이 필요하지 않습니다. uriKind 지정한 값은 uriString전달된 URI 형식과 일치해야 합니다. 그러나 RelativeOrAbsolute 지정한 경우 URI 문자열은 상대 문자열이거나 절대적일 수 있습니다.

Uri(Uri, String)

Source:

Uri.cs

지정된 기본 URI 및 상대 URI 문자열을 기반으로 Uri 클래스의 새 인스턴스를 초기화합니다.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);

public Uri (Uri baseUri, string? relativeUri);

new Uri : Uri * string -> Uri

Public Sub New (baseUri As Uri, relativeUri As String)

매개 변수

baseUri

Uri

기본 URI입니다.

relativeUri

String

기본 URI에 추가할 상대 URI입니다.

예외

ArgumentNullException

baseUri null.

ArgumentOutOfRangeException

baseUri 절대 Uri 인스턴스가 아닙니다.

UriFormatException

참고: windows 스토어 앱 또는 이식 가능한 클래스 라이브러리.NET에서 기본 클래스 예외인 대신 catch합니다.

baseUri relativeUri 결합하여 형성된 URI는 비어 있거나 공백만 포함합니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 체계가 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에는 너무 많은 슬래시가 포함됩니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 암호가 잘못되었습니다.

-또는-

baseUri relativeUri 결합하여 형성된 URI에 지정된 호스트 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 파일 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 사용자 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

baseUri relativeUri 결합하여 형성된 URI의 길이가 65519자를 초과합니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

baseUri relativeUri결합하여 구성한 URI에 잘못된 문자 시퀀스가 있습니다.

-또는-

baseUri 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

예제

다음 예제에서는 상대 URI http://www.contoso.com 결합하고 catalog/shownew.htm 결합하여 절대 URI http://www.contoso.com/catalog/shownew.htm형성하여 Uri 클래스의 새 인스턴스를 만듭니다.

Uri^ baseUri = gcnew Uri(  "http://www.contoso.com" );
Uri^ myUri = gcnew Uri( baseUri, "catalog/shownew.htm" );
Console::WriteLine( myUri->ToString() );

Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

설명

이 생성자는 baseUrirelativeUri결합하여 Uri 인스턴스를 만듭니다. relativeUri 절대 URI(체계, 호스트 이름 및 선택적으로 포트 번호 포함)인 경우 Uri 인스턴스는 relativeUri사용하여 만들어집니다.

baseUri 상대 부분(예: /api)이 있는 경우 baseUri 상대 부분을 생성된 Uri보존하려면 상대 부분을 슬래시(예: /api/)로 종료해야 합니다.

또한 relativeUri 슬래시로 시작하는 경우 baseUri

이 생성자는 Uri 액세스 가능한 리소스를 참조하도록 보장하지 않습니다.

Uri(Uri, Uri)

Source:

Uri.cs

지정된 기본 Uri 인스턴스와 상대 Uri 인스턴스의 조합에 따라 Uri 클래스의 새 인스턴스를 초기화합니다.

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);

public Uri (Uri baseUri, Uri relativeUri);

new Uri : Uri * Uri -> Uri

Public Sub New (baseUri As Uri, relativeUri As Uri)

매개 변수

baseUri

Uri

새 Uri 인스턴스의 기반이 되는 절대 Uri.

relativeUri

Uri

baseUri결합된 상대 Uri 인스턴스입니다.

예외

ArgumentException

baseUri 절대 Uri 인스턴스가 아닙니다.

ArgumentNullException

baseUri null.

ArgumentOutOfRangeException

baseUri 절대 Uri 인스턴스가 아닙니다.

UriFormatException

참고: windows 스토어 앱 또는 이식 가능한 클래스 라이브러리.NET에서 기본 클래스 예외인 대신 catch합니다.

baseUri relativeUri 결합하여 형성된 URI는 비어 있거나 공백만 포함합니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 체계가 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에는 너무 많은 슬래시가 포함됩니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 암호가 잘못되었습니다.

-또는-

baseUri relativeUri 결합하여 형성된 URI에 지정된 호스트 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 파일 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 사용자 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

baseUri relativeUri 결합하여 형성된 URI의 길이가 65519자를 초과합니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

baseUri relativeUri결합하여 구성한 URI에 잘못된 문자 시퀀스가 있습니다.

-또는-

baseUri 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

예제

이 예제에서는 절대 Uri 인스턴스, absoluteUri및 상대 Uri 인스턴스 relativeUri만듭니다. combinedUri새 Uri 인스턴스는 이 두 인스턴스에서 만들어집니다.

// Create an absolute Uri from a string.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// Check whether the new Uri is absolute or relative.
if (  !relativeUri->IsAbsoluteUri )
   Console::WriteLine( "{0} is a relative Uri.", relativeUri );

// Create a new Uri from an absolute Uri and a relative Uri.
Uri^ combinedUri = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );

// Create an absolute Uri from a string.
Uri absoluteUri = new Uri("http://www.contoso.com/");

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

// Check whether the new Uri is absolute or relative.
if (!relativeUri.IsAbsoluteUri)
    Console.WriteLine("{0} is a relative Uri.", relativeUri);

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);

// Create an absolute Uri from a string.
let absoluteUri = Uri "http://www.contoso.com/"

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
let relativeUri = Uri("/catalog/shownew.htm?date=today", UriKind.Relative)

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{combinedUri.AbsoluteUri}"

    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

설명

이 생성자는 baseUri절대 Uri 인스턴스와 상대 Uri 인스턴스 relativeUri결합하여 새 Uri 인스턴스를 만듭니다. relativeUri 절대 Uri 인스턴스(구성표, 호스트 이름 및 선택적으로 포트 번호 포함)인 경우 Uri 인스턴스는 relativeUri사용하여 만들어집니다.

baseUri 상대 부분(예: /api)이 있는 경우 baseUri 상대 부분을 생성된 Uri보존하려면 상대 부분을 슬래시(예: /api/)로 종료해야 합니다.

또한 relativeUri 슬래시로 시작하는 경우 baseUri

이 생성자는 Uri 액세스 가능한 리소스를 참조하도록 보장하지 않습니다.

Uri(Uri, String, Boolean)

Source:

Uri.cs

주의

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.

문자 이스케이프를 명시적으로 제어하여 지정된 기본 및 상대 URI를 기반으로 Uri 클래스의 새 인스턴스를 초기화합니다.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri (Uri baseUri, string? relativeUri, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

매개 변수

baseUri

Uri

기본 URI입니다.

relativeUri

String

기본 URI에 추가할 상대 URI입니다.

dontEscape

Boolean

baseUri 및 relativeUri 완전히 이스케이프되면 true. 그렇지 않으면 false.

특성

ObsoleteAttribute

예외

ArgumentNullException

baseUri null.

ArgumentOutOfRangeException

baseUri 절대 Uri 인스턴스가 아닙니다.

UriFormatException

baseUri relativeUri 결합하여 형성된 URI는 비어 있거나 공백만 포함합니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 체계가 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에는 너무 많은 슬래시가 포함됩니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 암호가 잘못되었습니다.

-또는-

baseUri relativeUri 결합하여 형성된 URI에 지정된 호스트 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 파일 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 사용자 이름이 잘못되었습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 호스트 또는 기관 이름은 백슬라이시로 종료할 수 없습니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.

-또는-

baseUri relativeUri 결합하여 형성된 URI의 길이가 65519자를 초과합니다.

-또는-

baseUri 및 relativeUri 결합하여 형성된 URI에 지정된 구성표의 길이가 1023자를 초과합니다.

-또는-

baseUri relativeUri결합하여 구성한 URI에 잘못된 문자 시퀀스가 있습니다.

-또는-

baseUri 지정된 MS-DOS 경로는 c:\\로 시작해야 합니다.

예제

다음 예제에서는 상대 URI http://www.contoso.com 결합 하 여 Uri 클래스의 새 인스턴스를 만들고 절대 URI를 형성 하는 Hello%20World.htm 합니다.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri^ myUri = gcnew Uri( baseUri,"Hello%20World.htm",false );

Uri baseUri = new Uri("http://www.contoso.com");
Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "Hello%20World.htm", false)

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

설명

이 생성자는 baseUrirelativeUri결합하여 Uri 인스턴스를 만듭니다. relativeUri 전달된 URI가 절대 URI(구성표, 호스트 이름 및 선택적으로 포트 번호 포함)인 경우 Uri 인스턴스는 relativeUri사용하여 만들어집니다.

dontEscape 매개 변수는 예약된 문자가 이스케이프 시퀀스로 변환되는지 여부를 제어합니다. 이 매개 변수는 URI의 모든 예약 문자가 이스케이프된 것으로 확신하는 경우에만 true 설정해야 합니다. 완전히 이스케이프되지 않은 URI의 값을 true 설정하면 예기치 않은 동작이 발생할 수 있습니다. 항상 이 매개 변수를 false설정하는 것이 좋습니다. dontEscape false설정된 경우 생성자는 모든 발생률(%)이 유효한 이스케이프 시퀀스 뒤에 있는지 확인하여 예약된 문자를 이스케이프합니다. 백분율을 따르는 문자 시퀀스가 유효하지 않으면 백분율이 %25대체됩니다.

이 생성자는 Uri 액세스 가능한 리소스를 참조하도록 보장하지 않습니다.

호출자 참고

보안 문제로 인해 애플리케이션은 신뢰할 수 없는 원본의 URI 문자열과 truedontEscape 설정된 상태에서 이 생성자를 호출해서는 안 됩니다. 또는 이 생성자를 호출하기 전에 IsWellFormedOriginalString() 메서드를 호출하여 URI 문자열의 유효성을 확인할 수 있습니다.