WebRequest.Create Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Requests.dll

Menginisialisasi baru WebRequest.

Overload

Create(String)	Kedaluwarsa. Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan.
Create(Uri)	Kedaluwarsa. Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan.

Create(String)

Sumber:

WebRequest.cs

Perhatian

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

Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan.

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

Parameter

requestUriString

String

URI yang mengidentifikasi sumber daya Internet.

Mengembalikan

WebRequest

WebRequest Turunan untuk skema URI tertentu.

Atribut

ObsoleteAttribute

Pengecualian

NotSupportedException

Skema permintaan yang ditentukan di requestUriString belum didaftarkan.

ArgumentNullException

requestUriStringadalah null.

SecurityException

Pemanggil tidak memiliki WebPermissionAttribute izin untuk menyambungkan ke URI yang diminta atau URI tempat permintaan dialihkan.

UriFormatException

URI yang ditentukan di requestUriString bukan URI yang valid.

Catatan: Di .NET untuk aplikasi Bursa Windows atau Pustaka Kelas Portabel, tangkap pengecualian kelas dasar, FormatException, sebagai gantinya.

Contoh

Contoh berikut menggunakan untuk membuat instans CreateHttpWebRequest . String yang mewakili URL target digunakan sebagai parameter konstruktor.

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

Keterangan

Metode mengembalikan Create turunan dari kelas yang WebRequest ditentukan pada durasi sebagai kecocokan terdaftar terdekat untuk requestUri.

Misalnya, ketika URI dimulai dengan http:// atau https:// diteruskan dalam requestUri, dikembalikan HttpWebRequest oleh Create. Jika URI yang dimulai dengan ftp:// diteruskan sebagai gantinya Create , metode akan mengembalikan FtpWebRequest instans. Jika URI yang dimulai dengan file:// diteruskan sebagai gantinya Create , metode akan mengembalikan FileWebRequest instans.

Jenis cadangan pra-terdaftar yang sudah terdaftar meliputi yang berikut ini:

• http://

• https://

• ftp://

• file://

.NET mencakup dukungan untuk http://skema URI , https://, ftp://, dan file:// . Turunan kustom WebRequest untuk menangani permintaan lain terdaftar dengan metode .RegisterPrefix

Metode ini Create menggunakan parameter untuk membuat Uri instans requestUriString yang diteruskannya ke yang baruWebRequest.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Lihat juga

• Protokol Pluggable Pemrograman

Create(Uri)

Sumber:

WebRequest.cs

Perhatian

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

Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan.

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

Parameter

requestUri

Uri

yang Uri berisi URI sumber daya yang diminta.

Mengembalikan

WebRequest

WebRequest Turunan untuk skema URI yang ditentukan.

Atribut

ObsoleteAttribute

Pengecualian

NotSupportedException

Skema permintaan yang ditentukan di requestUri tidak terdaftar.

ArgumentNullException

requestUriadalah null.

SecurityException

Pemanggil tidak memiliki WebPermissionAttribute izin untuk menyambungkan ke URI yang diminta atau URI tempat permintaan dialihkan.

Contoh

Contoh berikut menggunakan untuk membuat instans CreateHttpWebRequest . Uri yang mewakili URL target digunakan sebagai parameter konstruktor.

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

Keterangan

Metode mengembalikan Create turunan dari kelas yang WebRequest ditentukan pada durasi sebagai kecocokan terdaftar terdekat untuk requestUri.

Misalnya, jika Anda membuat WebRequest turunan, Handler1, untuk menangani permintaan ke http://www.contoso.com/text/ dan yang lain bernama Handler2 untuk menangani permintaan ke http://www.contoso.com/code/, Anda dapat menggunakan Create metode untuk mengembalikan turunan WebRequest yang terkait dengan URI yang ditentukan.

Untuk mengembalikan turunan WebRequest kelas hanya berdasarkan bagian skema URI, gunakan CreateDefault metode .

Misalnya, ketika URI dimulai dengan http:// atau https:// diteruskan dalam requestUri, dikembalikan HttpWebRequest oleh Create. Jika URI yang dimulai dengan ftp:// diteruskan sebagai gantinya Create , metode akan mengembalikan FileWebRequest instans. Jika URI yang dimulai dengan file:// diteruskan sebagai gantinya Create , metode akan mengembalikan FileWebRequest instans.

Jenis cadangan pra-terdaftar yang sudah terdaftar meliputi yang berikut ini:

• http://

• https://

• ftp://

• file://

.NET mencakup dukungan untuk http://skema URI , https://, ftp://, dan file:// . Turunan kustom WebRequest untuk menangani permintaan lain terdaftar dengan metode .RegisterPrefix

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.