WebRequest.Create Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Requests.dll

Yeni WebRequestbir başlatır.

Aşırı Yüklemeler

Name	Description
Create(String)	Geçersiz. Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır.
Create(Uri)	Geçersiz. Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır.

Create(String)

Kaynak:

WebRequest.cs

Dikkat

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

Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır.

public:
 static System::Net::WebRequest ^ Create(System::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);

[<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

Parametreler

requestUriString

String

İnternet kaynağını tanımlayan URI.

Döndürülenler

WebRequest

WebRequest Belirli bir URI düzeni için alt öğe.

Öznitelikler

ObsoleteAttribute

Özel durumlar

NotSupportedException

içinde requestUriString belirtilen istek düzeni kaydedilmedi.

ArgumentNullException

requestUriString, null'e eşittir.

SecurityException

Çağıranın istenen URI'ye veya isteğin yeniden yönlendirildiği bir URI'ye bağlanma izni yok WebPermissionAttribute .

UriFormatException

içinde requestUriString belirtilen URI geçerli bir URI değil.

Not: Windows Store uygulamaları için .NET veya Portable Sınıf Kitaplığı bunun yerine FormatException temel sınıf özel durumunu yakalayın.

Örnekler

Aşağıdaki örnek bir Create örneği örneklemek için kullanırHttpWebRequest. Oluşturucu parametresi olarak hedef URL'yi temsil eden bir dize kullanılır.

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()

Açıklamalar

yöntemi, Create için en yakın kayıtlı eşleşme WebRequestolarak çalışma zamanında belirlenen sınıfın alt requestUri öğesini döndürür.

Örneğin, ile http:// başlayan veya https:// içinde requestUriHttpWebRequest geçirilen bir URI tarafından Createdöndürülür. Bunun yerine ile ftp:// başlayan bir URI geçirilirse, Create yöntemi bir FtpWebRequest örnek döndürür. Bunun yerine ile file:// başlayan bir URI geçirilirse, Create yöntemi bir FileWebRequest örnek döndürür.

Önceden kaydedilmiş yedek türleri şunlardır:

• http://

• https://

• ftp://

• file://

.NET, , http://, https://ve ftp:// URI düzenleri için file://destek içerir. WebRequest Diğer istekleri işlemek için özel alt öğeler yöntemiyle RegisterPrefix kaydedilir.

yöntemi parametresini CreaterequestUriString kullanarak yeni Uriöğesine geçirdiği bir WebRequest örnek oluşturur.

Note

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework Ağ İzleme.

Ayrıca bkz.

• Takılabilir Protokolleri Programlama

Create(Uri)

Kaynak:

WebRequest.cs

Dikkat

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

Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır.

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);

[<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

Parametreler

requestUri

Uri

Uri İstenen kaynağın URI'sini içeren.

Döndürülenler

WebRequest

WebRequest Belirtilen URI düzeni için alt öğe.

Öznitelikler

ObsoleteAttribute

Özel durumlar

NotSupportedException

içinde requestUri belirtilen istek düzeni kayıtlı değil.

ArgumentNullException

requestUri, null'e eşittir.

SecurityException

Çağıranın istenen URI'ye veya isteğin yeniden yönlendirildiği bir URI'ye bağlanma izni yok WebPermissionAttribute .

Örnekler

Aşağıdaki örnek bir Create örneği örneklemek için kullanırHttpWebRequest. Oluşturucu parametresi olarak hedef URL'yi temsil eden bir Uri kullanılır.

// 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()

Açıklamalar

yöntemi, Create için en yakın kayıtlı eşleşme WebRequestolarak çalışma zamanında belirlenen sınıfın alt requestUri öğesini döndürür.

Örneğin, istekleri işlemek için handler1 alt öğesini ve istekleri WebRequest işlemek http://www.contoso.com/text/için başka bir http://www.contoso.com/code/ adlandırılmış Handler2 oluşturursanız, belirtilen URI'lerden biriyle ilişkili WebRequest alt öğesini döndürmek için yöntemini kullanabilirsinizCreate.

Bir URI'nin WebRequest yalnızca şema bölümünü temel alarak sınıfının alt öğesini döndürmek için yöntemini kullanın CreateDefault .

Örneğin, ile http:// başlayan veya https:// içinde requestUriHttpWebRequest geçirilen bir URI tarafından Createdöndürülür. Bunun yerine ile ftp:// başlayan bir URI geçirilirse, Create yöntemi bir FileWebRequest örnek döndürür. Bunun yerine ile file:// başlayan bir URI geçirilirse, Create yöntemi bir FileWebRequest örnek döndürür.

Önceden kaydedilmiş yedek türleri şunlardır:

• http://

• https://

• ftp://

• file://

.NET, , http://, https://ve ftp:// URI düzenleri için file://destek içerir. WebRequest Diğer istekleri işlemek için özel alt öğeler yöntemiyle RegisterPrefix kaydedilir.

Note

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework Ağ İzleme.