WebRequest.Create Metode

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.Requests.dll

Menginisialisasi baru WebRequest.

Overload

Nama	Deskripsi
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

Turunan WebRequest untuk skema URI tertentu.

Atribut

ObsoleteAttribute

Pengecualian

NotSupportedException

Skema permintaan yang ditentukan requestUriString belum didaftarkan.

ArgumentNullException

requestUriString adalah null.

SecurityException

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

UriFormatException

URI yang ditentukan dalam requestUriString bukan URI yang valid.

Contoh

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

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 kelas yang WebRequest ditentukan pada waktu proses sebagai kecocokan terdaftar terdekat untuk requestUri.

Misalnya, ketika URI dimulai dengan http:// atau https:// diteruskan di requestUri, ditampilkan 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 yang telah didaftarkan sebelumnya meliputi yang berikut ini:

• http://

• https://

• ftp://

• file://

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

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

Note

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

Lihat juga

• Protokol Yang Dapat Dicolokkan 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

Turunan WebRequest untuk skema URI yang ditentukan.

Atribut

ObsoleteAttribute

Pengecualian

NotSupportedException

Skema permintaan yang ditentukan di requestUri tidak terdaftar.

ArgumentNullException

requestUri adalah 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 =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 kelas yang WebRequest ditentukan pada waktu proses 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 tertentu.

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

Misalnya, ketika URI dimulai dengan http:// atau https:// diteruskan di requestUri, ditampilkan 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 yang telah didaftarkan sebelumnya meliputi yang berikut ini:

• http://

• https://

• ftp://

• file://

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

Note

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