WebRequest.Create 메서드

참조

정의

네임스페이스:: System.Net

어셈블리:: System.Net.Requests.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

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

새 WebRequest를 초기화합니다.

오버로드

Create(String)	사용되지 않습니다. 지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.
Create(Uri)	사용되지 않습니다. 지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.

Create(String)

주의

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);

public static System.Net.WebRequest Create (string requestUriString);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create (string requestUriString);

static member Create : string -> System.Net.WebRequest

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Net.WebRequest

Public Shared Function Create (requestUriString As String) As WebRequest

매개 변수

requestUriString: String

인터넷 리소스를 식별하는 URI입니다.

반환

WebRequest

특정 URI 체계에 대한 WebRequest 하위 항목입니다.

특성: ObsoleteAttribute

예외

NotSupportedException

requestUriString에 지정된 요청 체계가 등록되지 않은 경우

ArgumentNullException

requestUriString이(가) null인 경우

SecurityException

호출자에게 요청된 URI 또는 요청이 리디렉션되는 URI에 연결할 WebPermissionAttribute 권한이 없는 경우

UriFormatException

requestUriString에 지정된 URI가 유효한 URI가 아닌 경우

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

예제

다음 예제에서는 인스턴스를 인스턴스화하는 HttpWebRequest 데 사용합니다Create. 대상 URL을 나타내는 문자열이 생성자 매개 변수로 사용됩니다.

Uri^ ourUri = gcnew Uri( url );

// Create a 'WebRequest' object with the specified url.
WebRequest^ myWebRequest = WebRequest::Create( url );

// Send the 'WebRequest' and wait for response.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if ( ourUri->Equals( myWebResponse->ResponseUri ) )
{
   Console::WriteLine( "\nRequest Url : {0} was not redirected", url );
}
else
{
   Console::WriteLine( "\nRequest Url : {0} was redirected to {1}", url, myWebResponse->ResponseUri );
}

// Release resources of response object.
myWebResponse->Close();

Uri ourUri = new Uri(url);            

// Create a 'WebRequest' object with the specified url. 
WebRequest myWebRequest = WebRequest.Create(url); 

// Send the 'WebRequest' and wait for response.
WebResponse myWebResponse = myWebRequest.GetResponse(); 

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if (ourUri.Equals(myWebResponse.ResponseUri))
    Console.WriteLine("\nRequest Url : {0} was not redirected",url);   
else
    Console.WriteLine("\nRequest Url : {0} was redirected to {1}",url,myWebResponse.ResponseUri);   
// Release resources of response object.
myWebResponse.Close();


Dim ourUri As New Uri(url)
' Create a 'WebRequest' object with the specified url. 

Dim myWebRequest As WebRequest = WebRequest.Create(url)

' Send the 'WebRequest' and wait for response.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

' "ResponseUri" property is used to get the actual Uri from where the response was attained.
If ourUri.Equals(myWebResponse.ResponseUri) Then
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was not redirected", url)
Else
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was redirected to {1}", url, myWebResponse.ResponseUri)
End If 

' Release resources of response object.
myWebResponse.Close()

설명

이 메서드는 Create 런타임에 WebRequest 가장 가까운 등록된 일치 항목으로 결정되는 클래스의 하위 항목을 반환합니다 requestUri.

예를 들어 URI가 시작 http:// 되거나 https:// 전달되면 HttpWebRequest requestUriURI가 반환Create됩니다. 대신 URI로 ftp:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FtpWebRequest 반환합니다. 대신 URI로 file:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FileWebRequest 반환합니다.

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

http://
https://
ftp://
file://

.NET에는 , https://및 ftp://``file:// URI 스키마에 대한 http://지원이 포함됩니다. 다른 요청을 처리하는 사용자 지정 WebRequest 하위 항목이 메서드에 RegisterPrefix 등록됩니다.

메서드는 Create 매개 변수를 requestUriString 사용하여 새 WebRequest인스턴스에 전달하는 인스턴스를 만듭니 Uri 다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

추가 정보

플러그형 프로토콜 프로그래밍

적용 대상

Create(Uri)

주의

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);

public static System.Net.WebRequest Create (Uri requestUri);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create (Uri requestUri);

static member Create : Uri -> System.Net.WebRequest

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : Uri -> System.Net.WebRequest

Public Shared Function Create (requestUri As Uri) As WebRequest

매개 변수

requestUri: Uri

요청된 리소스의 URI가 포함된 Uri입니다.

반환

WebRequest

지정된 URI 체계에 대한 WebRequest 하위 항목입니다.

특성: ObsoleteAttribute

예외

NotSupportedException

requestUri에서 지정된 요청 체계가 등록되어 있지 않은 경우

ArgumentNullException

requestUri이(가) null인 경우

SecurityException

호출자에게 요청된 URI 또는 요청이 리디렉션되는 URI에 연결할 WebPermissionAttribute 권한이 없는 경우

예제

다음 예제에서는 인스턴스를 인스턴스화하는 HttpWebRequest 데 사용합니다Create. 대상 URL을 나타내는 Uri가 생성자 매개 변수로 사용됩니다.

// Create a new 'Uri' object with the specified string.
Uri^ myUri = gcnew Uri( "http://www.contoso.com" );
// Create a new request to the above mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( myUri );
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Create a new 'Uri' object with the specified string.
Uri myUri =new Uri("http://www.contoso.com");
// Create a new request to the above mentioned URL.	
WebRequest myWebRequest= WebRequest.Create(myUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse= myWebRequest.GetResponse();

' Create a new 'Uri' object with the specified string.
Dim myUri As New Uri("http://www.contoso.com")
' Create a new request to the above mentioned URL.	
Dim myWebRequest As WebRequest = WebRequest.Create(myUri)
'  Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

설명

이 메서드는 Create 런타임에 WebRequest 가장 가까운 등록된 일치 항목으로 결정되는 클래스의 하위 항목을 반환합니다 requestUri.

예를 들어 요청을 처리하기 위해 하위 항목인 Handler1을 만들고 요청을 처리하는 http://www.contoso.com/code/``http://www.contoso.com/text/ 다른 Handler2를 만드는 WebRequest 경우 메서드를 사용하여 Create 지정된 URI와 연결된 WebRequest 하위 항목을 반환할 수 있습니다.

URI의 구성표 부분만 기반으로 클래스의 WebRequest 하위 항목을 반환하려면 메서드를 CreateDefault 사용합니다.

예를 들어 URI가 시작 http:// 되거나 https:// 전달되면 HttpWebRequest requestUriURI가 반환Create됩니다. 대신 URI로 ftp:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FileWebRequest 반환합니다. 대신 URI로 file:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FileWebRequest 반환합니다.

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

http://
https://
ftp://
file://

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

적용 대상

WebRequest.Create 메서드

정의

오버로드

Create(String)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

Create(Uri)

매개 변수

반환

예외

예제

설명

적용 대상

추가 리소스