WebRequest.Create Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Requests.dll

Yeni WebRequestbir başlatır.

Aşırı Yüklemeler

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 şeması kaydedilmedi.

ArgumentNullException

requestUriString, null değeridir.

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 Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayın.

Örnekler

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

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

Açıklamalar

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

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

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

• http://

• https://

• ftp://

• file://

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

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Ayrıca bkz.

• Takılabilir Protokoller 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 şeması kayıtlı değil.

ArgumentNullException

requestUri, null değeridir.

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 HttpWebRequest örneği örneklemek için kullanırCreate. 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 = 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()

Açıklamalar

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

Örneğin, için istekleri işlemek için işleyici1 WebRequest alt öğesi ve istekleri http://www.contoso.com/text/ işlemek http://www.contoso.com/code/için handler2 adlı başka bir ad oluşturursanız, belirtilen URI'lerden biriyle ilişkili WebRequest alt öğesini döndürmek için yöntemini kullanabilirsiniz Create .

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 başlayan veya ile http:// başlayan bir URI geçirildiğinderequestUri, tarafından Createdöndürülür HttpWebRequesthttps://. Bunun yerine ile ftp:// başlayan bir URI geçirilirse yöntemi Create bir FileWebRequest örnek döndürür. Bunun yerine ile file:// başlayan bir URI geçirilirse yöntemi Create bir FileWebRequest örnek döndürür.

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

• http://

• https://

• ftp://

• file://

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.