Uri 생성자
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Uri 클래스의 새 인스턴스를 초기화합니다.
오버로드
| Name | Description |
|---|---|
| Uri(String) |
지정된 URI를 사용하여 클래스의 Uri 새 인스턴스를 초기화합니다. |
| Uri(SerializationInfo, StreamingContext) |
사용되지 않음.
지정된 클래스 인스턴스에서 클래스의 Uri 새 인스턴스를 SerializationInfoStreamingContext 초기화합니다. |
| 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(String)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- 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은 null입니다.
uriString 가 비어 있습니다.
-또는-
지정된 uriString 체계가 올바르게 구성되지 않았습니다.
CheckSchemeName(String)을(를) 참조하세요.
-또는-
uriString 에는 너무 많은 슬래시가 포함되어 있습니다.
-또는-
지정된 uriString 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 잘못되었습니다.
-또는-
지정된 uriString 호스트 또는 기관 이름은 백슬라이시로 종료됩니다.
-또는-
지정된 uriString 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.
-또는-
길이 uriString 가 65519자를 초과합니다(.NET 9 및 이전 버전에만 해당).
-또는-
지정한 uriString 구성표의 길이가 1023자를 초과합니다.
-또는-
에 잘못된 문자 시퀀스가 있습니다 uriString.
-또는-
지정된 uriString MS-DOS 경로가 c:\\로 시작되지 않습니다.
예제
다음 예제에서는 URIhttp://www.contoso.com/를 사용하여 Uri 인스턴스를 만듭니다.
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 하지 않습니다.
uriString IPv6 주소를 나타내는 경우 대괄호 안에 묶어야 합니다(예: "http://[2607:f8b0:400d:c06::69]").
이 생성자는 매개 변수가 string 절대 URI를 참조하고 로 설정된 생성자를 UriKind 호출 Uri 하는 것과 같다고 가정합니다Absolute.
string 생성자에 전달된 매개 변수가 상대 URI이면 이 생성자는 을 throw합니다UriFormatException.
적용 대상
Uri(SerializationInfo, StreamingContext)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
주의
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
지정된 클래스 인스턴스에서 클래스의 Uri 새 인스턴스를 SerializationInfoStreamingContext 초기화합니다.
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);
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
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)
매개 변수
- serializationInfo
- SerializationInfo
새 Uri 인스턴스를 serialize하는 데 필요한 정보입니다.
- streamingContext
- StreamingContext
새 Uri 인스턴스와 연결된 직렬화된 스트림의 원본입니다.
- 특성
예외
매개 변수에 serializationInfo URI가 null 포함되어 있습니다.
매개 변수에는 serializationInfo 비어 있는 URI가 포함되어 있습니다.
-또는-
지정한 체계가 올바르게 구성되지 않았습니다. CheckSchemeName(String)을(를) 참조하세요.
-또는-
URI에 너무 많은 슬래시가 포함되어 있습니다.
-또는-
URI에 지정된 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 잘못되었습니다.
-또는-
URI에 지정된 호스트 또는 기관 이름은 백슬라이시로 종료됩니다.
-또는-
URI에 지정된 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.
-또는-
URI 길이가 65519자를 초과합니다(.NET 9 및 이전 버전에만 해당).
-또는-
URI에 지정된 구성표의 길이가 1023자를 초과합니다.
-또는-
URI에 잘못된 문자 시퀀스가 있습니다.
-또는-
URI에 지정된 MS-DOS 경로가 c:\\로 시작되지 않습니다.
설명
이 생성자는 클래스에 ISerializable 대한 인터페이스를 구현합니다 Uri .
추가 정보
적용 대상
Uri(String, Boolean)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
주의
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.
주의
This constructor has been deprecated. Use Uri(string) instead.
주의
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
주의
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("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. 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. https://go.microsoft.com/fwlink/?linkid=14202")]
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("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. 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. https://go.microsoft.com/fwlink/?linkid=14202")>]
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
인스턴스에서 나타낼 리소스를 식별하는 문자열입니다 Uri . 문자열 형식의 IPv6 주소는 대괄호 안에 묶어야 합니다. 예를 들어 "http://[2607:f8b0:400d:c06::69]"입니다.
- dontEscape
- Boolean
- 특성
예외
uriString은 null입니다.
uriString 가 비어 있거나 공백만 포함됩니다.
-또는-
지정한 uriString 체계가 잘못되었습니다.
-또는-
uriString 에는 너무 많은 슬래시가 포함되어 있습니다.
-또는-
지정된 uriString 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 잘못되었습니다.
-또는-
지정된 uriString 호스트 또는 기관 이름은 백슬라이시로 종료됩니다.
-또는-
지정된 uriString 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.
-또는-
길이 uriString 가 65519자를 초과합니다(.NET 9 및 이전 버전에만 해당).
-또는-
지정한 uriString 구성표의 길이가 1023자를 초과합니다.
-또는-
에 잘못된 문자 시퀀스가 있습니다 uriString.
-또는-
지정된 uriString MS-DOS 경로가 c:\\로 시작되지 않습니다.
설명
이 생성자는 URI 문자열에서 인스턴스를 만듭니다 Uri . URI를 구문 분석하고 정식 형식으로 배치합니다.
매개 변수는 예약된 문자가 이 dontEscape 스케이프 시퀀스로 변환되는지 여부를 제어합니다. 이 매개 변수는 URI의 true 모든 예약 문자가 이스케이프된 것으로 확신하는 경우에만 설정해야 합니다. 완전히 이스케이프되지 않은 URI에 대해 값을 true 설정하면 예기치 않은 동작이 발생할 수 있습니다. 항상 이 매개 변수 false를 .로 설정하는 것이 좋습니다.
설정된 false경우 dontEscape 생성자는 모든 발생률(%)에 유효한 이스케이프 시퀀스가 뒤따르는지 확인하여 예약된 문자를 이스케이프합니다. 백분율을 따르는 문자 시퀀스가 유효하지 않으면 백분율이 %25대체됩니다.
이 생성자는 액세스 가능한 리소스를 참조하도록 보장 Uri 하지 않습니다.
적용 대상
Uri(String, UriCreationOptions)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
지정된 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)
매개 변수
- creationOptions
- UriCreationOptions
생성 및 동작 방식을 Uri 제어하는 옵션입니다.
적용 대상
Uri(String, UriKind)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- 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)
매개 변수
- uriKind
- UriKind
URI 문자열이 상대 URI, 절대 URI인지, 아니면 확정되지 않았는지를 지정합니다.
예외
uriKind 가 잘못되었습니다.
uriString은 null입니다.
uriString 는 상대 URI를 포함하고 있습니다 uriKindAbsolute.
또는
uriString 는 절대 URI를 포함하고 있습니다 uriKindRelative.
또는
uriString 가 비어 있습니다.
-또는-
지정된 uriString 체계가 올바르게 구성되지 않았습니다.
CheckSchemeName(String)을(를) 참조하세요.
-또는-
uriString 에는 너무 많은 슬래시가 포함되어 있습니다.
-또는-
지정된 uriString 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 잘못되었습니다.
-또는-
지정된 uriString 호스트 또는 기관 이름은 백슬라이시로 종료됩니다.
-또는-
지정된 uriString 포트 번호가 잘못되었거나 구문 분석할 수 없습니다.
-또는-
길이 uriString 가 65519자를 초과합니다(.NET 9 및 이전 버전에만 해당).
-또는-
지정한 uriString 구성표의 길이가 1023자를 초과합니다.
-또는-
에 잘못된 문자 시퀀스가 있습니다 uriString.
-또는-
지정된 uriString MS-DOS 경로가 c:\\로 시작되지 않습니다.
설명
상대 URI와 절대 URI의 형식에 대한 제한 사항이 다릅니다. 예를 들어 상대 URI에는 체계나 권한이 필요하지 않습니다. 지정 uriKind 한 값은 전달된 uriStringURI 형식과 일치해야 합니다. 그러나 지정된 경우 RelativeOrAbsolute URI 문자열은 상대 또는 절대 문자열일 수 있습니다.
문자열 uriString형식의 IPv6 주소는 대괄호 안에 묶어야 합니다(예: "http://[2607:f8b0:400d:c06::69]").
적용 대상
Uri(Uri, String)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
지정된 기본 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입니다.
예외
baseUri은 null입니다.
baseUri 는 절대 Uri 인스턴스가 아닙니다.
결합 baseUri 하여 형성된 URI이며 relativeUri 비어 있거나 공백만 포함합니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 체계이며 relativeUri 유효하지 않습니다.
-또는-
결합하여 형성된 baseUri URI이며 relativeUri 슬래시가 너무 많습니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 올 relativeUri 바르지 않습니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 호스트 또는 기관 이름이며 relativeUri 백 슬래시로 종료됩니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 포트 번호이며 relativeUri 유효하지 않거나 구문 분석할 수 없습니다.
-또는-
65519자(.NET 9 및 relativeUri 이전 버전에만 해당)를 결합하여 baseUri 구성한 URI의 길이입니다.
-또는-
1023자를 조합 baseUrirelativeUri 하여 형성된 URI에 지정된 구성표의 길이입니다.
-또는-
URI에 결합 및 relativeUri결합을 통해 구성된 잘못된 문자 시퀀스가 있습니다baseUri.
-또는-
지정된 baseUri MS-DOS 경로가 c:\\로 시작되지 않습니다.
예제
다음 예제에서는 상대 URI http://www.contoso.comcatalog/shownew.htm 를 Uri 결합하고 절대 URIhttp://www.contoso.com/catalog/shownew.htm를 형성하여 클래스의 새 인스턴스를 만듭니다.
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. 절대 URI(구성표, 호스트 이름 및 선택적으로 포트 번호 포함)인 경우 relativeUri 인스턴스는 Uri 만 relativeUri사용하여 만들어집니다.
baseUri 상대 부분(예: /api)이 있는 경우 상대 부분은 생성된 Uri부분에 보존되어야 하는 경우 baseUri 슬래시(예: /api/)로 종료되어야 합니다.
또한 슬래시로 relativeUri 시작하는 경우 해당 항목의 상대 부분을 바꿉니다. baseUri
이 생성자는 액세스 가능한 리소스를 참조하도록 보장 Uri 하지 않습니다.
적용 대상
Uri(Uri, Uri)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
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 인스턴스가 아닙니다.
baseUri은 null입니다.
baseUri 는 절대 Uri 인스턴스가 아닙니다.
결합 baseUri 하여 형성된 URI이며 relativeUri 비어 있거나 공백만 포함합니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 체계이며 relativeUri 유효하지 않습니다.
-또는-
결합하여 형성된 baseUri URI이며 relativeUri 슬래시가 너무 많습니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 올 relativeUri 바르지 않습니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 호스트 또는 기관 이름이며 relativeUri 백 슬래시로 종료됩니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 포트 번호이며 relativeUri 유효하지 않거나 구문 분석할 수 없습니다.
-또는-
65519자(.NET 9 및 relativeUri 이전 버전에만 해당)를 결합하여 baseUri 구성한 URI의 길이입니다.
-또는-
1023자를 조합 baseUrirelativeUri 하여 형성된 URI에 지정된 구성표의 길이입니다.
-또는-
URI에 결합 및 relativeUri결합을 통해 구성된 잘못된 문자 시퀀스가 있습니다baseUri.
-또는-
지정된 baseUri MS-DOS 경로가 c:\\로 시작되지 않습니다.
예제
이 예제에서는 절대 Uri 인스턴스 absoluteUri및 상대 Uri 인스턴스 relativeUri를 만듭니다. 그런 다음, combinedUri이 두 인스턴스에서 새 Uri 인스턴스가 만들어집니다.
// 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 인스턴스baseUrirelativeUri를 만듭니다. 절대 Uri 인스턴스(구성표, 호스트 이름 및 선택적으로 포트 번호 포함)Uri인 경우 relativeUri 인스턴스는 만 relativeUri사용하여 만들어집니다.
baseUri 상대 부분(예: /api)이 있는 경우 상대 부분은 생성된 Uri부분에 보존되어야 하는 경우 baseUri 슬래시(예: /api/)로 종료되어야 합니다.
또한 슬래시baseUri로 relativeUri 시작하는 경우 .
이 생성자는 액세스 가능한 리소스를 참조하도록 보장 Uri 하지 않습니다.
적용 대상
Uri(Uri, String, Boolean)
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
- Source:
- Uri.cs
주의
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.
주의
This constructor has been deprecated. Use Uri(Uri, string) instead.
주의
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
주의
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를 기반으로 클래스의 새 인스턴스를 초기화합니다.
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. 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. 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. 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("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. 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. https://go.microsoft.com/fwlink/?linkid=14202")>]
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
- 특성
예외
baseUri은 null입니다.
baseUri 는 절대 Uri 인스턴스가 아닙니다.
결합 baseUri 하여 형성된 URI이며 relativeUri 비어 있거나 공백만 포함합니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 체계이며 relativeUri 유효하지 않습니다.
-또는-
결합하여 형성된 baseUri URI이며 relativeUri 슬래시가 너무 많습니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 암호, 호스트 이름, 파일 이름 또는 사용자 이름이 올 relativeUri 바르지 않습니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 호스트 또는 기관 이름이며 relativeUri 백 슬래시로 종료됩니다.
-또는-
결합 baseUri 하여 형성된 URI에 지정된 포트 번호이며 relativeUri 유효하지 않거나 구문 분석할 수 없습니다.
-또는-
65519자(.NET 9 및 relativeUri 이전 버전에만 해당)를 결합하여 baseUri 구성한 URI의 길이입니다.
-또는-
1023자를 조합 baseUrirelativeUri 하여 형성된 URI에 지정된 구성표의 길이입니다.
-또는-
URI에 결합 및 relativeUri결합을 통해 구성된 잘못된 문자 시퀀스가 있습니다baseUri.
-또는-
지정된 baseUri MS-DOS 경로가 c:\\로 시작되지 않습니다.
설명
이 생성자는 결합하여 relativeUri인스턴스를 baseUri 만듭니다Uri. 전달된 relativeUri URI가 절대 URI(구성표, 호스트 이름 및 선택적으로 포트 번호 포함) Uri 인 경우 인스턴스는 만 relativeUri사용하여 만들어집니다.
매개 변수는 예약된 문자가 이 dontEscape 스케이프 시퀀스로 변환되는지 여부를 제어합니다. 이 매개 변수는 URI의 true 모든 예약 문자가 이스케이프된 것으로 확신하는 경우에만 설정해야 합니다. 완전히 이스케이프되지 않은 URI에 대해 값을 true 설정하면 예기치 않은 동작이 발생할 수 있습니다. 항상 이 매개 변수 false를 .로 설정하는 것이 좋습니다. 설정된 false경우 dontEscape 생성자는 모든 발생률(%)에 유효한 이스케이프 시퀀스가 뒤따르는지 확인하여 예약된 문자를 이스케이프합니다. 백분율을 따르는 문자 시퀀스가 유효하지 않으면 백분율이 %25대체됩니다.
이 생성자는 액세스 가능한 리소스를 참조하도록 보장 Uri 하지 않습니다.
호출자 참고
보안 문제로 인해 애플리케이션은 신뢰할 수 없는 원본의 URI 문자열과 설정된 true상태에서 이 생성자를 호출해서는 안 됩니다dontEscape. 또는 이 생성자를 호출하기 전에 메서드를 호출하여 URI 문자열의 IsWellFormedOriginalString() 유효성을 확인할 수 있습니다.