WebRequest Kelas

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Requests.dll

Sumber:

WebRequest.cs

Membuat permintaan ke Pengidentifikasi Sumber Daya Seragam (URI). Ini adalah kelas abstract.

public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable

public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

Warisan

Object

MarshalByRefObject

WebRequest

Turunan

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Penerapan

ISerializable

Contoh

Contoh berikut menunjukkan cara membuat instans WebRequest 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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

WebRequest adalah kelas dasar abstract 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 kelas WebRequest 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 turunan WebRequest 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 melemparkan WebException ketika kesalahan terjadi saat mengakses sumber daya Internet. Properti Status adalah salah satu nilai WebExceptionStatus yang menunjukkan sumber kesalahan. Ketika StatusWebExceptionStatus.ProtocolError, properti Response berisi WebResponse yang diterima dari sumber daya Internet.

Karena kelas WebRequest adalah kelas abstract, perilaku aktual instans WebRequest pada waktu proses ditentukan oleh kelas turunan yang dikembalikan oleh metode Create. Untuk informasi selengkapnya tentang nilai dan pengecualian default, lihat dokumentasi untuk kelas turunan, seperti HttpWebRequest dan FileWebRequest.

Nota

Gunakan metode Create untuk menginisialisasi instans WebRequest baru. Jangan gunakan konstruktor WebRequest.

Nota

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, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object), dan EndGetResponse(IAsyncResult). Selain itu, Anda harus menyediakan implementasi antarmuka IWebRequestCreate, yang menentukan metode Create(Uri) yang digunakan saat Anda memanggil Create(Uri). Anda harus mendaftarkan kelas yang mengimplementasikan antarmuka IWebRequestCreate, menggunakan metode RegisterPrefix(String, IWebRequestCreate) atau file konfigurasi.

Konstruktor

WebRequest()	Kedaluwarsa. Menginisialisasi instans baru kelas WebRequest.
WebRequest(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans baru kelas WebRequest dari instans yang ditentukan dari kelas SerializationInfo dan StreamingContext.

Properti

AuthenticationLevel	Mendapatkan atau menetapkan nilai yang menunjukkan tingkat autentikasi dan peniruan yang digunakan untuk permintaan ini.
CachePolicy	Mendapatkan atau mengatur kebijakan cache untuk permintaan ini.
ConnectionGroupName	Saat ditimpa di kelas turunan, mendapatkan atau mengatur 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.
Credentials	Saat ditimpa di kelas turunan, mendapatkan atau mengatur kredensial jaringan yang digunakan untuk mengautentikasi permintaan dengan sumber daya Internet.
DefaultCachePolicy	Mendapatkan atau mengatur 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 nilai Boolean yang mengontrol apakah DefaultCredentials dikirim dengan permintaan.

Metode

Abort()	Membatalkan permintaan.
BeginGetRequestStream(AsyncCallback, Object)	Saat ditimpa di kelas turunan, berikan versi asinkron dari metode GetRequestStream().
BeginGetResponse(AsyncCallback, Object)	Ketika ditimpa di kelas turunan, memulai permintaan asinkron untuk sumber daya Internet.
Create(String)	Kedaluwarsa. Menginisialisasi instans WebRequest baru untuk skema URI yang ditentukan.
Create(Uri)	Kedaluwarsa. Menginisialisasi instans WebRequest baru untuk skema URI yang ditentukan.
CreateDefault(Uri)	Kedaluwarsa. Menginisialisasi instans WebRequest baru untuk skema URI yang ditentukan.
CreateHttp(String)	Kedaluwarsa. Menginisialisasi instans HttpWebRequest baru untuk string URI yang ditentukan.
CreateHttp(Uri)	Kedaluwarsa. Menginisialisasi instans HttpWebRequest baru 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 SerializationInfo dengan data yang 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 pengguna yang saat ini ditiru.
GetType()	Mendapatkan Type instans 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 Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
RegisterPrefix(String, IWebRequestCreate)	Mendaftarkan turunan WebRequest untuk URI yang ditentukan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Kedaluwarsa. Saat ditimpa di kelas turunan, mengisi instans SerializationInfo dengan data yang diperlukan untuk menserialisasikan WebRequest.

Lihat juga

• HttpWebRequest
• Meminta data
• Protokol Pluggable Pemrograman