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 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 turunan 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 melempar 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 diberikan secara eksplisit kepada pengguna untuk melakukannya.

Catatan Bagi Implementer

Ketika Anda mewarisi dari WebRequest, Anda harus mengambil alih anggota berikut: Method, , RequestUri, Headers, ContentLength, CredentialsContentType, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), 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 yang ditentukan dari SerializationInfo kelas dan StreamingContext .

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 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 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)	Saat 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 Internet Explorer dari pengguna yang saat ini ditiru.
GetType()	Mendapatkan dari 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 saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
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 membuat serialisasi WebRequest.

Lihat juga

• HttpWebRequest
• Meminta Data
• Protokol Pluggable Pemrograman