Uri 생성자

참조

정의

네임스페이스:: System

어셈블리:: System.Runtime.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

오버로드

Uri(String)	URI가 지정된 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(SerializationInfo, StreamingContext)	Uri와 SerializationInfo 클래스에 지정된 인스턴스에서 StreamingContext 클래스의 새 인스턴스를 초기화합니다.
Uri(String, Boolean)	사용되지 않습니다. 사용되지 않습니다. 사용되지 않습니다. 문자 이스케이프를 명시적으로 제어하여 URI가 지정된 Uri 클래스의 새 인스턴스를 초기화합니다.
Uri(String, UriCreationOptions)	지정된 URI 및 추가 URI를 Uri 사용하여 클래스의 새 인스턴스를 초기화합니다 UriCreationOptions.
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 클래스의 새 인스턴스를 초기화합니다.

Uri(String)

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 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 FormatException을 catch합니다.

uriString가 비어 있는 경우

또는

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

또는

uriString에 너무 많은 슬래시가 들어 있습니다.

또는

uriString에서 지정된 암호가 올바르지 않습니다.

또는

uriString에서 지정된 호스트 이름이 올바르지 않습니다.

또는

uriString에서 지정된 파일 이름이 올바르지 않습니다.

또는

uriString에서 지정된 사용자 이름이 올바르지 않습니다.

또는

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

또는

uriString에서 지정된 포트 번호가 올바르지 않거나 해당 번호를 구문 분석할 수 없습니다.

또는

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

또는

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

또는

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

또는

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

예제

다음 예제에서는 URIhttp://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를 참조하는 것으로 가정하며 , 이 매개 변수가 URI로 설정된 생성자를 UriKind 호출 Uri 하는 것과 같다고 가정합니다Absolute. string 생성자에 전달된 매개 변수가 상대 URI이면 이 생성자는 을 throw합니다UriFormatException.

적용 대상

Uri(SerializationInfo, StreamingContext)

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

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

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

new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

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

매개 변수

serializationInfo: SerializationInfo

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

streamingContext: StreamingContext

새 StreamingContext 인스턴스와 관련하여 serialize된 스트림의 소스가 포함된 Uri 클래스의 인스턴스입니다.

예외

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:\\로 시작해야 합니다.

설명

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

추가 정보

XML 및 SOAP Serialization

적용 대상

Uri(String, Boolean)

주의

The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

주의

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

주의

The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202

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

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

[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (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("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (string uriString, bool dontEscape);

public Uri (string uriString, bool dontEscape);

[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri

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

[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri

new Uri : string * bool -> Uri

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

매개 변수

uriString: String

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:\\로 시작해야 합니다.

예제

다음 예제에서는 URIhttp://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를 .로 설정하는 것이 좋습니다.

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

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

적용 대상

Uri(String, UriCreationOptions)

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

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)

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

uriKind: UriKind

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

예외

ArgumentException

uriKind이 잘못되었습니다.

ArgumentNullException

uriString이(가) null인 경우

UriFormatException

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

uriString이 상대 URI를 포함하고 uriKind가 Absolute인 경우

또는

uriString이 절대 URI를 포함하고 uriKind가 Relative인 경우

또는

uriString가 비어 있는 경우

또는

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

또는

uriString에 너무 많은 슬래시가 들어 있습니다.

또는

uriString에서 지정된 암호가 올바르지 않습니다.

또는

uriString에서 지정된 호스트 이름이 올바르지 않습니다.

또는

uriString에서 지정된 파일 이름이 올바르지 않습니다.

또는

uriString에서 지정된 사용자 이름이 올바르지 않습니다.

또는

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

또는

uriString에서 지정된 포트 번호가 올바르지 않거나 해당 번호를 구문 분석할 수 없습니다.

또는

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

또는

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

또는

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

또는

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

설명

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

적용 대상

Uri(Uri, String)

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

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

public Uri (Uri baseUri, 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 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 FormatException을 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에 잘못된 문자 시퀀스가 있습니다.

또는

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

예제

다음 예제에서는 상대 URI catalog/shownew.htm http://www.contoso.com 를 결합 하 고 절대 URIhttp://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())

설명

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

상대 부분(예: )이 baseUri 있는 경우 상대 부분을 슬래시Uri(예: )baseUri로 /api/종료해야 /api합니다.

또한 슬래시로 시작하는 경우 relativeUri 슬래시의 상대 부분을 바꿉니다. baseUri

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

적용 대상

Uri(Uri, Uri)

지정된 기본 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

Uri와 결합되는 상대 baseUri 인스턴스입니다.

예외

ArgumentException

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

ArgumentNullException

baseUri이(가) null인 경우

ArgumentOutOfRangeException

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

UriFormatException

참고: Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 FormatException을 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에 잘못된 문자 시퀀스가 있습니다.

또는

uriString에 지정된 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

설명

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

baseUri 상대 부분(예: /api)이 있는 경우 상대 부분을 슬래시Uri(예: )baseUri로 /api/종료해야 합니다.

또한 슬래시로 시작하는 경우 relativeUri 해당 슬래시의 상대 부분을 바꿉니다. baseUri

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

적용 대상

Uri(Uri, String, Boolean)

주의

The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

주의

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

주의

The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202

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

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

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
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.")]
public Uri (Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, string relativeUri, bool dontEscape);

public Uri (Uri baseUri, string relativeUri, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, string relativeUri, bool dontEscape);

[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri

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

[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri

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

uriString이 이스케이프되면 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에 잘못된 문자 시퀀스가 있습니다.

또는

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

예제

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

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)

설명

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

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

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

호출자 참고

보안 문제 때문에 애플리케이션은이 생성자를 호출 하지이 URI 문자열을 사용 하 여 신뢰할 수 없는 소스에서 사용 하 여 dontEscape 로 true합니다. 또는 이 생성자를 호출하기 전에 메서드를 호출하여 URI 문자열의 IsWellFormedOriginalString() 유효성을 확인할 수 있습니다.

적용 대상

Uri 생성자

정의

오버로드

Uri(String)

매개 변수

예외

예제

설명

적용 대상

Uri(SerializationInfo, StreamingContext)

매개 변수

예외

설명

추가 정보

적용 대상

Uri(String, Boolean)

매개 변수

예외

예제

설명

적용 대상

Uri(String, UriCreationOptions)

매개 변수

적용 대상

Uri(String, UriKind)

매개 변수

예외

설명

적용 대상

Uri(Uri, String)

매개 변수

예외

예제

설명

적용 대상

Uri(Uri, Uri)

매개 변수

예외

예제

설명

적용 대상

Uri(Uri, String, Boolean)

매개 변수

예외

예제

설명

호출자 참고

적용 대상

추가 리소스