WebRequest.Create 메서드

정의

WebRequest을 초기화합니다.

오버로드

Name Description
Create(String)
사용되지 않음.

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

Create(Uri)
사용되지 않음.

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

Create(String)

Source:
WebRequest.cs
Source:
WebRequest.cs
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 스키마의 하위 항목입니다.

특성

예외

지정된 requestUriString 요청 체계가 등록되지 않았습니다.

requestUriStringnull입니다.

호출자에게 요청된 URI 또는 요청이 리디렉션되는 URI에 연결할 수 있는 권한이 없습니다 WebPermissionAttribute .

지정된 requestUriString URI가 유효한 URI가 아닙니다.

예제

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

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:// 전달되면 requestUriHttpWebRequestCreate. 대신 URI로 ftp:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FtpWebRequest 반환합니다. 대신 URI로 file:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FileWebRequest 반환합니다.

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

  • http://

  • https://

  • ftp://

  • file://

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

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

메모

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

추가 정보

적용 대상

Create(Uri)

Source:
WebRequest.cs
Source:
WebRequest.cs
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를 포함하는 A.

반품

WebRequest 지정된 URI 스키마의 하위 항목입니다.

특성

예외

지정된 requestUri 요청 체계가 등록되지 않았습니다.

requestUrinull입니다.

호출자에게 요청된 URI 또는 요청이 리디렉션되는 URI에 연결할 수 있는 권한이 없습니다 WebPermissionAttribute .

예제

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

// 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:// 전달되면 requestUriHttpWebRequestCreate. 대신 URI로 ftp:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FileWebRequest 반환합니다. 대신 URI로 file:// 시작하는 URI가 전달되면 메서드는 Create 인스턴스를 FileWebRequest 반환합니다.

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

  • http://

  • https://

  • ftp://

  • file://

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

메모

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

적용 대상