다음을 통해 공유

WebRequest.Create 메서드

  • 참조

정의

네임스페이스:
System.Net
어셈블리:
System.Net.Requests.dll
어셈블리:
System.dll
어셈블리:
netstandard.dll

새 WebRequest를 초기화합니다.

오버로드

Create(String)
사용되지 않음.

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

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

Create(String)

Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

주의

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합니다.

예제

다음 예제에서는 를 사용하여 Create 인스턴스를 인스턴스화합니다 HttpWebRequest . 대상 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.

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

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

  • http://

  • https://

  • ftp://

  • file://

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

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

참고

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

추가 정보

적용 대상

Create(Uri)

Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

주의

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 권한이 없는 경우

예제

다음 예제에서는 를 사용하여 Create 인스턴스를 인스턴스화합니다 HttpWebRequest . 대상 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/text/http://www.contoso.com/code/처리하기 위해 Handler2라는 또 다른 이름을 만드는 WebRequest 경우 메서드를 사용하여 Create 지정된 URI와 연결된 WebRequest 하위 항목을 반환할 수 있습니다.

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

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

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

  • http://

  • https://

  • ftp://

  • file://

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

참고

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

적용 대상