WebRequest Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuat permintaan ke Pengidentifikasi Sumber Daya Seragam (URI). Ini adalah kelas abstract
.
public ref class WebRequest abstract
public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable
public abstract class WebRequest
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable
[System.Serializable]
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable
type WebRequest = class
type WebRequest = class
inherit MarshalByRefObject
interface ISerializable
[<System.Serializable>]
type WebRequest = class
inherit MarshalByRefObject
interface ISerializable
Public MustInherit Class WebRequest
Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable
- Warisan
-
WebRequest
- Warisan
- Turunan
- Atribut
- Penerapan
Contoh
Contoh berikut menunjukkan cara membuat WebRequest instans dan mengembalikan respons.
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Text;
int main()
{
// Create a request for the URL.
WebRequest^ request = WebRequest::Create( "http://www.contoso.com/default.html" );
// If required by the server, set the credentials.
request->Credentials = CredentialCache::DefaultCredentials;
// Get the response.
HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
// Display the status.
Console::WriteLine( response->StatusDescription );
// Get the stream containing content returned by the server.
Stream^ dataStream = response->GetResponseStream();
// Open the stream using a StreamReader for easy access.
StreamReader^ reader = gcnew StreamReader( dataStream );
// Read the content.
String^ responseFromServer = reader->ReadToEnd();
// Display the content.
Console::WriteLine( responseFromServer );
// Cleanup the streams and the response.
reader->Close();
dataStream->Close();
response->Close();
}
using System;
using System.IO;
using System.Net;
using System.Text;
namespace Examples.System.Net
{
public class WebRequestGetExample
{
public static void Main ()
{
// Create a request for the URL.
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
// Display the status.
Console.WriteLine (response.StatusDescription);
// Get the stream containing content returned by the server.
Stream dataStream = response.GetResponseStream ();
// Open the stream using a StreamReader for easy access.
StreamReader reader = new StreamReader (dataStream);
// Read the content.
string responseFromServer = reader.ReadToEnd ();
// Display the content.
Console.WriteLine (responseFromServer);
// Cleanup the streams and the response.
reader.Close ();
dataStream.Close ();
response.Close ();
}
}
}
Imports System.IO
Imports System.Net
Imports System.Text
Namespace Examples.System.Net
Public Class WebRequestGetExample
Public Shared Sub Main()
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
' Display the status.
Console.WriteLine(response.StatusDescription)
' Get the stream containing content returned by the server.
Dim dataStream As Stream = response.GetResponseStream()
' Open the stream using a StreamReader for easy access.
Dim reader As New StreamReader(dataStream)
' Read the content.
Dim responseFromServer As String = reader.ReadToEnd()
' Display the content.
Console.WriteLine(responseFromServer)
' Cleanup the streams and the response.
reader.Close()
dataStream.Close()
response.Close()
End Sub
End Class
End Namespace
Keterangan
Penting
Jangan gunakan WebRequest
atau kelas turunannya untuk pengembangan baru. Sebagai gantinya System.Net.Http.HttpClient , gunakan kelas .
WebRequestabstract
adalah kelas dasar untuk . Model permintaan/respons NET untuk mengakses data dari Internet. Aplikasi yang menggunakan model permintaan/respons dapat meminta data dari Internet dengan cara protokol-agnostik, di mana aplikasi bekerja dengan instans WebRequest kelas sementara kelas turunan khusus protokol melakukan detail permintaan.
Permintaan dikirim dari aplikasi ke URI tertentu, seperti halaman Web di server. URI menentukan kelas turunan yang tepat untuk dibuat dari daftar WebRequest keturunan yang terdaftar untuk aplikasi. WebRequest Turunan biasanya terdaftar untuk menangani protokol tertentu, seperti HTTP atau FTP, tetapi dapat didaftarkan untuk menangani permintaan ke server atau jalur tertentu di server.
Kelas WebRequest memunculkan WebException ketika kesalahan terjadi saat mengakses sumber daya Internet. Properti Status adalah salah WebExceptionStatus satu nilai yang menunjukkan sumber kesalahan. Ketika Status adalah WebExceptionStatus.ProtocolError, Response properti berisi yang WebResponse diterima dari sumber daya Internet.
WebRequest Karena kelas adalah abstract
kelas, perilaku WebRequest aktual instans pada durasi ditentukan oleh kelas turunan yang dikembalikan oleh Create metode . Untuk informasi selengkapnya tentang nilai dan pengecualian default, lihat dokumentasi untuk kelas turunan, seperti HttpWebRequest dan FileWebRequest.
Catatan
Create Gunakan metode untuk menginisialisasi instans baruWebRequest. Jangan gunakan WebRequest konstruktor.
Catatan
Jika aplikasi yang membuat objek WebRequest berjalan dengan kredensial pengguna Normal, aplikasi tidak akan dapat mengakses sertifikat yang diinstal di penyimpanan komputer lokal kecuali izin telah secara eksplisit diberikan kepada pengguna untuk melakukannya.
Catatan Bagi Implementer
Ketika Anda mewarisi dari WebRequest, Anda harus mengambil alih anggota berikut: Method, , , RequestUriHeadersContentLength, , ContentTypeCredentials, PreAuthenticate, BeginGetRequestStream(AsyncCallback, Object)GetRequestStream(), EndGetRequestStream(IAsyncResult), GetResponse(), , BeginGetResponse(AsyncCallback, Object), dan .EndGetResponse(IAsyncResult) Selain itu, Anda harus menyediakan implementasi IWebRequestCreate antarmuka, yang menentukan metode yang Create(Uri) digunakan saat Anda memanggil Create(Uri). Anda harus mendaftarkan kelas yang mengimplementasikan IWebRequestCreate antarmuka, menggunakan RegisterPrefix(String, IWebRequestCreate) metode atau file konfigurasi.
Konstruktor
WebRequest() |
Kedaluwarsa.
Menginisialisasi instans baru kelas WebRequest. |
WebRequest(SerializationInfo, StreamingContext) |
Kedaluwarsa.
Menginisialisasi instans WebRequest baru kelas dari instans SerializationInfo dan StreamingContext kelas yang ditentukan. |
Properti
AuthenticationLevel |
Mendapatkan atau menetapkan nilai yang menunjukkan tingkat autentikasi dan peniruan yang digunakan untuk permintaan ini. |
CachePolicy |
Mendapatkan atau menetapkan kebijakan cache untuk permintaan ini. |
ConnectionGroupName |
Saat ditimpa di kelas turunan, mendapatkan atau menetapkan nama grup koneksi untuk permintaan tersebut. |
ContentLength |
Saat ditimpa di kelas turunan, mendapatkan atau mengatur panjang konten data permintaan yang dikirim. |
ContentType |
Saat ditimpa di kelas turunan, mendapatkan atau mengatur jenis konten data permintaan yang dikirim. |
CreatorInstance |
Kedaluwarsa.
Ketika ditimpa di kelas turunan, mendapatkan objek pabrik yang berasal dari kelas yang IWebRequestCreate digunakan untuk membuat WebRequest instans untuk membuat permintaan ke URI yang ditentukan. |
Credentials |
Ketika ditimpa di kelas turunan, mendapatkan atau mengatur kredensial jaringan yang digunakan untuk mengautentikasi permintaan dengan sumber daya Internet. |
DefaultCachePolicy |
Mendapatkan atau menetapkan kebijakan cache default untuk permintaan ini. |
DefaultWebProxy |
Mendapatkan atau mengatur proksi HTTP global. |
Headers |
Saat ditimpa di kelas turunan, mendapatkan atau mengatur kumpulan pasangan nama/nilai header yang terkait dengan permintaan. |
ImpersonationLevel |
Mendapatkan atau mengatur tingkat peniruan untuk permintaan saat ini. |
Method |
Ketika ditimpa di kelas turunan, mendapatkan atau mengatur metode protokol untuk digunakan dalam permintaan ini. |
PreAuthenticate |
Saat ditimpa di kelas turunan, menunjukkan apakah akan melakukan pra-autentikasi permintaan. |
Proxy |
Ketika ditimpa di kelas turunan, mendapatkan atau mengatur proksi jaringan untuk digunakan untuk mengakses sumber daya Internet ini. |
RequestUri |
Ketika ditimpa di kelas turunan, mendapatkan URI sumber daya Internet yang terkait dengan permintaan. |
Timeout |
Mendapatkan atau mengatur lamanya waktu, dalam milidetik, sebelum waktu permintaan habis. |
UseDefaultCredentials |
Saat ditimpa di kelas turunan, mendapatkan atau menetapkan Boolean nilai yang mengontrol apakah DefaultCredentials dikirim dengan permintaan. |
Metode
Abort() |
Membatalkan permintaan. |
BeginGetRequestStream(AsyncCallback, Object) |
Saat ditimpa di kelas turunan, berikan versi GetRequestStream() metode asinkron. |
BeginGetResponse(AsyncCallback, Object) |
Ketika ditimpa di kelas turunan, memulai permintaan asinkron untuk sumber daya Internet. |
Create(String) |
Kedaluwarsa.
Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan. |
Create(Uri) |
Kedaluwarsa.
Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan. |
CreateDefault(Uri) |
Kedaluwarsa.
Menginisialisasi instans baru WebRequest untuk skema URI yang ditentukan. |
CreateHttp(String) |
Kedaluwarsa.
Menginisialisasi instans baru HttpWebRequest untuk string URI yang ditentukan. |
CreateHttp(Uri) |
Kedaluwarsa.
Menginisialisasi instans baru HttpWebRequest untuk URI yang ditentukan. |
CreateObjRef(Type) |
Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject) |
EndGetRequestStream(IAsyncResult) |
Saat ditimpa di kelas turunan, mengembalikan Stream untuk menulis data ke sumber daya Internet. |
EndGetResponse(IAsyncResult) |
Saat ditimpa di kelas turunan, mengembalikan WebResponse. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetLifetimeService() |
Kedaluwarsa.
Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject) |
GetObjectData(SerializationInfo, StreamingContext) |
Kedaluwarsa.
Mengisi dengan data yang SerializationInfo diperlukan untuk membuat serialisasi objek target. |
GetRequestStream() |
Saat ditimpa di kelas turunan, mengembalikan Stream untuk menulis data ke sumber daya Internet. |
GetRequestStreamAsync() |
Saat ditimpa di kelas turunan, mengembalikan Stream untuk menulis data ke sumber daya Internet sebagai operasi asinkron. |
GetResponse() |
Saat ditimpa di kelas turunan, mengembalikan respons terhadap permintaan Internet. |
GetResponseAsync() |
Saat ditimpa di kelas turunan, mengembalikan respons terhadap permintaan Internet sebagai operasi asinkron. |
GetSystemWebProxy() |
Mengembalikan proksi yang dikonfigurasi dengan pengaturan opsi Internet dari pengguna yang saat ini ditiru. |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
InitializeLifetimeService() |
Kedaluwarsa.
Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
MemberwiseClone(Boolean) |
Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject) |
RegisterPortableWebRequestCreator(IWebRequestCreate) |
Kedaluwarsa.
IWebRequestCreate Daftarkan objek. |
RegisterPrefix(String, IWebRequestCreate) |
WebRequest Mendaftarkan turunan untuk URI yang ditentukan. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Implementasi Antarmuka Eksplisit
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Kedaluwarsa.
Ketika ditimpa di kelas turunan, mengisi instans dengan data yang SerializationInfo diperlukan untuk menserialisasikan WebRequest. |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk