WebRequest.RegisterPrefix(String, IWebRequestCreate) 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.Requests.dll

Source:

WebRequest.cs

지정된 URI에 대한 WebRequest 하위 항목을 등록합니다.

public:
 static bool RegisterPrefix(System::String ^ prefix, System::Net::IWebRequestCreate ^ creator);

public static bool RegisterPrefix (string prefix, System.Net.IWebRequestCreate creator);

static member RegisterPrefix : string * System.Net.IWebRequestCreate -> bool

Public Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As Boolean

매개 변수

prefix

String

WebRequest 하위 서비스에 대한 전체 URI 또는 URI 접두사입니다.

creator

IWebRequestCreate

WebRequest 호출하여 WebRequest 하위 항목을 만드는 create 메서드입니다.

반환

Boolean

등록에 성공했는지 true. 그렇지 않으면 false.

예외

ArgumentNullException

prefix null

-또는-

creator null.

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

RegisterPrefix 메서드는 WebRequest 하위 항목을 서비스 요청에 등록합니다. WebRequest 하위 항목은 일반적으로 HTTP 또는 FTP와 같은 특정 프로토콜을 처리하도록 등록되지만 서버의 특정 서버 또는 경로에 대한 요청을 처리하도록 등록할 수 있습니다.

미리 등록된 예약 유형은 다음과 같습니다.

• http://

• https://

• ftp://

• file://

자세한 내용은 Create(String) 및 Create(Uri) 메서드를 참조하세요.

중복된 접두사는 허용되지 않습니다. RegisterPrefix 중복 접두사를 등록하려고 하면 false 반환합니다.

메모

HttpWebRequest 클래스는 기본적으로 HTTP 및 HTTPS 스키마에 대한 서비스 요청에 등록됩니다. 이러한 스키마에 대해 다른 WebRequest 하위 항목을 등록하려고 하면 실패합니다.