WebRequest Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Requests.dll

Kaynak:

WebRequest.cs

Tekdüzen Kaynak Tanımlayıcısı'na (URI) istekte bulunur. Bu bir abstract sınıfıdır.

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

Devralma

Object

MarshalByRefObject

WebRequest

Türetilmiş

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Uygulamalar

ISerializable

Örnekler

Aşağıdaki örnekte, WebRequest örneği oluşturma ve yanıtı döndürme gösterilmektedir.

#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

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

WebRequest için abstract temel sınıfıdır. İNTERNET'ten verilere erişmek için NET'in istek/yanıt modeli. İstek/yanıt modelini kullanan bir uygulama, protokole özgü alt sınıflar isteğin ayrıntılarını gerçekleştirirken uygulamanın WebRequest sınıfı örnekleriyle çalıştığı protokolden bağımsız bir şekilde İnternet'ten veri isteyebilir.

İstekler bir uygulamadan sunucudaki Web sayfası gibi belirli bir URI'ye gönderilir. URI, uygulama için kaydedilen WebRequest alt öğeler listesinden oluşturulacak uygun alt sınıfı belirler. WebRequest alt öğeleri genellikle HTTP veya FTP gibi belirli bir protokolü işlemek üzere kaydedilir, ancak belirli bir sunucuya veya sunucudaki yola yönelik bir isteği işlemek için kaydedilebilir.

WebRequest sınıfı, İnternet kaynağına erişirken hatalar oluştuğunda bir WebException oluşturur. Status özelliği, hatanın kaynağını gösteren WebExceptionStatus değerlerinden biridir. Status WebExceptionStatus.ProtocolErrorolduğunda, Response özelliği İnternet kaynağından alınan WebResponse içerir.

WebRequest sınıfı abstract bir sınıf olduğundan, çalışma zamanında WebRequest örneklerin gerçek davranışı, Create yöntemi tarafından döndürülen alt sınıf tarafından belirlenir. Varsayılan değerler ve özel durumlar hakkında daha fazla bilgi için HttpWebRequest ve FileWebRequestgibi alt sınıfların belgelerine bakın.

Not

Yeni WebRequest örneklerini başlatmak için Create yöntemini kullanın. WebRequest oluşturucuyu kullanmayın.

Not

WebRequest nesnesini oluşturan uygulama Normal bir kullanıcının kimlik bilgileriyle çalışıyorsa, kullanıcıya açıkça izin verilmediği sürece uygulama yerel makine deposunda yüklü sertifikalara erişemez.

Uygulayanlara Notlar

WebRequestdevraldığınızda, şu üyeleri geçersiz kılmalısınız: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)ve EndGetResponse(IAsyncResult). Ayrıca, Create(Uri)çağırdığınızda kullanılan Create(Uri) yöntemini tanımlayan IWebRequestCreate arabiriminin bir uygulamasını sağlamanız gerekir. RegisterPrefix(String, IWebRequestCreate) yöntemini veya yapılandırma dosyasını kullanarak IWebRequestCreate arabirimini uygulayan sınıfı kaydetmeniz gerekir.

Oluşturucular

WebRequest()	Geçersiz. WebRequest sınıfının yeni bir örneğini başlatır.
WebRequest(SerializationInfo, StreamingContext)	Geçersiz. SerializationInfo ve StreamingContext sınıflarının belirtilen örneklerinden WebRequest sınıfının yeni bir örneğini başlatır.

Özellikler

AuthenticationLevel	Bu istek için kullanılan kimlik doğrulaması ve kimliğe bürünme düzeyini gösteren değerleri alır veya ayarlar.
CachePolicy	Bu istek için önbellek ilkesini alır veya ayarlar.
ConnectionGroupName	Alt sınıfta geçersiz kılındığında, istek için bağlantı grubunun adını alır veya ayarlar.
ContentLength	Alt sınıfta geçersiz kılındığında, gönderilen istek verilerinin içerik uzunluğunu alır veya ayarlar.
ContentType	Alt sınıfta geçersiz kılındığında, gönderilen istek verilerinin içerik türünü alır veya ayarlar.
Credentials	Alt sınıfta geçersiz kılındığında, isteğin kimliğini İnternet kaynağıyla doğrulamak için kullanılan ağ kimlik bilgilerini alır veya ayarlar.
DefaultCachePolicy	Bu istek için varsayılan önbellek ilkesini alır veya ayarlar.
DefaultWebProxy	Genel HTTP proxy'sini alır veya ayarlar.
Headers	Bir alt sınıfta geçersiz kılındığında, istekle ilişkili üst bilgi adı/değer çiftleri koleksiyonunu alır veya ayarlar.
ImpersonationLevel	Geçerli istek için kimliğe bürünme düzeyini alır veya ayarlar.
Method	Alt sınıfta geçersiz kılındığında, bu istekte kullanılacak protokol yöntemini alır veya ayarlar.
PreAuthenticate	Bir alt sınıfta geçersiz kılındığında, isteğin ön kimliğinin doğrulanıp doğrulanmayacağını gösterir.
Proxy	Alt sınıfta geçersiz kılındığında, bu İnternet kaynağına erişmek için kullanılacak ağ ara sunucusunu alır veya ayarlar.
RequestUri	Alt sınıfta geçersiz kılındığında, istekle ilişkili İnternet kaynağının URI'sini alır.
Timeout	İstek zaman aşımına uğramadan önce milisaniye cinsinden süreyi alır veya ayarlar.
UseDefaultCredentials	Alt sınıfta geçersiz kılındığında, DefaultCredentials isteklerle gönderilip gönderilmediğini denetleyen bir Boolean değeri alır veya ayarlar.

Yöntemler

Abort()	İsteği durdurur.
BeginGetRequestStream(AsyncCallback, Object)	Bir alt sınıfta geçersiz kılındığında, GetRequestStream() yönteminin zaman uyumsuz bir sürümünü sağlar.
BeginGetResponse(AsyncCallback, Object)	Alt sınıfta geçersiz kılındığında, İnternet kaynağı için zaman uyumsuz bir istek başlar.
Create(String)	Geçersiz. Belirtilen URI düzeni için yeni bir WebRequest örneği başlatır.
Create(Uri)	Geçersiz. Belirtilen URI düzeni için yeni bir WebRequest örneği başlatır.
CreateDefault(Uri)	Geçersiz. Belirtilen URI düzeni için yeni bir WebRequest örneği başlatır.
CreateHttp(String)	Geçersiz. Belirtilen URI dizesi için yeni bir HttpWebRequest örneği başlatır.
CreateHttp(Uri)	Geçersiz. Belirtilen URI için yeni bir HttpWebRequest örneği başlatır.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	Alt sınıfta geçersiz kılındığında, İnternet kaynağına veri yazmak için bir Stream döndürür.
EndGetResponse(IAsyncResult)	Bir alt sınıfta geçersiz kılındığında, bir WebResponsedöndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Geçersiz. Bir SerializationInfo hedef nesneyi seri hale getirmek için gereken verilerle doldurur.
GetRequestStream()	Alt sınıfta geçersiz kılındığında, İnternet kaynağına veri yazmak için bir Stream döndürür.
GetRequestStreamAsync()	Alt sınıfta geçersiz kılındığında, İnternet kaynağına zaman uyumsuz bir işlem olarak veri yazmak için bir Stream döndürür.
GetResponse()	Alt sınıfta geçersiz kılındığında, İnternet isteğine bir yanıt döndürür.
GetResponseAsync()	Alt sınıfta geçersiz kılındığında, zaman uyumsuz bir işlem olarak İnternet isteğine bir yanıt döndürür.
GetSystemWebProxy()	Kimliğine bürünülen kullanıcının İnternet seçenekleri ayarlarıyla yapılandırılmış bir ara sunucu döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
RegisterPrefix(String, IWebRequestCreate)	Belirtilen URI için WebRequest alt öğesini kaydeder.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Geçersiz. Bir alt sınıfta geçersiz kılındığında, bir SerializationInfo örneğini WebRequestserileştirmek için gereken verilerle doldurur.

Ayrıca bkz.

• HttpWebRequest
• veri isteme
• Takılabilir Protokolleri programlama