WebRequest.Create Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net

Bütünleştirilmiş Kodlar:: System.dll, System.Net.Requests.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Net.Requests.dll

Bütünleştirilmiş Kod:: System.Net.Requests.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Yeni WebRequestbir başlatır.

Aşırı Yüklemeler

Create(String)	Geçersiz. Belirtilen URI şeması için yeni WebRequest bir örnek başlatır.
Create(Uri)	Geçersiz. Belirtilen URI şeması için yeni WebRequest bir örnek başlatır.

Create(String)

Kaynak:: WebRequest.cs

Kaynak:: WebRequest.cs

Kaynak:: WebRequest.cs

Dikkat

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

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

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

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ın alt WebRequest öğesini için requestUrien yakın kayıtlı eşleşme olarak döndürür.

Örneğin, ile http:// başlayan veya https:// içinde requestUriHttpWebRequest geçirilen bir URI tarafından döndürülürCreate. 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öntemine RegisterPrefix kaydedilir.

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

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Ayrıca bkz.

Takılabilir Protokoller Programlama

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler (Kullanım dışı)
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5 (6, 7, 8, 9)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Create(Uri)

Kaynak:: WebRequest.cs

Kaynak:: WebRequest.cs

Kaynak:: WebRequest.cs

Dikkat

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

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

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

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

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ın alt WebRequest öğesini için requestUrien yakın kayıtlı eşleşme olarak döndürür.

Örneğin, WebRequest istekleri işlemek için handler1 alt öğesini ve istekleri http://www.contoso.com/text/ işlemek http://www.contoso.com/code/için başka bir adlandırılmış Handler2 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 alan sınıfı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 döndürülürCreate. 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öntemine RegisterPrefix kaydedilir.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Şunlara uygulanır

.NET 9 ve diğer sürümler

Ürün	Sürümler (Kullanım dışı)
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5 (6, 7, 8, 9)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Aracılığıyla paylaş

WebRequest.Create Yöntem

Tanım

Aşırı Yüklemeler

Create(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Create(Uri)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar