HttpWebRequest Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Requests.dll

Kaynak:

HttpWebRequest.cs

Sınıfının HTTP'ye özgü bir uygulamasını WebRequest sağlar.

public ref class HttpWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable

public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

type HttpWebRequest = class
    inherit WebRequest
    interface ISerializable

Public Class HttpWebRequest
Inherits WebRequest
Implements ISerializable

Devralma

Object

MarshalByRefObject

WebRequest

HttpWebRequest

Uygulamalar

ISerializable

Örnekler

Aşağıdaki kod örneği URI http://www.contoso.com/için bir HttpWebRequest oluşturur.

HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");

Dim myReq As HttpWebRequest = _
    WebRequest.Create("http://www.contoso.com/")

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.

sınıfı, HttpWebRequest kullanıcının HTTP kullanarak sunucularla doğrudan etkileşim kurmasını sağlayan ek özellikler ve yöntemler için ve içinde WebRequest tanımlanan özellikler ve yöntemler için destek sağlar.

Oluşturucuyu HttpWebRequest kullanmayın. WebRequest.Create Yeni HttpWebRequest nesneleri başlatmak için yöntemini kullanın. Tekdüzen Kaynak Tanımlayıcısı (URI) şeması veya https://Create ise http:// bir HttpWebRequest nesne döndürür.

yöntemi özelliğinde GetResponse belirtilen kaynağa zaman uyumlu istekte RequestUri bulunur ve yanıt nesnesini içeren bir HttpWebResponse döndürür. Yanıt verileri tarafından GetResponseStreamdöndürülen akış kullanılarak alınabiliyor. Yanıt nesnesi veya yanıt akışı kapatılırsa kalan veriler kaybedilir. Kalan veriler boşaltılır ve aşağıdaki koşullar geçerliyse yanıt nesnesi veya akışı kapatılırken sonraki istekler için yuva yeniden kullanılır: bu bir canlı tutma veya işlem hattı isteğidir, yalnızca az miktarda veri alınması gerekir veya kalan veriler küçük bir zaman aralığında alınır. Belirtilen koşullardan hiçbiri tutmazsa veya boşaltma süresi aşılırsa yuva kapatılır. Canlı tutma veya işlem hattı bağlantıları için uygulamanın EOF'ye kadar akışları okumasını kesinlikle öneririz. Bu, daha iyi performans ve daha az kaynak kullanılmasına neden olan sonraki istekler için yuvanın yeniden kullanılmasını sağlar.

Kaynağa veri göndermek istediğinizde, GetRequestStream yöntemi veri göndermek için kullanılacak bir Stream nesne döndürür. BeginGetRequestStream ve EndGetRequestStream yöntemleri, veri gönderme akışına zaman uyumsuz erişim sağlar.

ile HttpWebRequestistemci kimlik doğrulaması için, istemci sertifikası geçerli kullanıcının Sertifikam deposuna yüklenmelidir.

sınıfı, HttpWebRequest bir WebException kaynağa erişirken hatalar oluştuğunda bir oluşturur. özelliği, WebException.Status hatanın kaynağını gösteren bir WebExceptionStatus değer içerir. olduğunda WebException.StatusWebExceptionStatus.ProtocolError, Response özelliği kaynaktan alınan öğesini içerir HttpWebResponse .

HttpWebRequest İnternet kaynağına özellik olarak gönderilen, yöntemlere göre ayarlanan veya sistem tarafından ayarlanan yaygın HTTP üst bilgi değerlerini kullanıma sunar; aşağıdaki tabloda tam bir liste yer alır. Özelliğindeki Headers diğer üst bilgileri ad/değer çiftleri olarak ayarlayabilirsiniz. Sunucuların ve önbelleklerin istek sırasında üst bilgileri değiştirebileceğini veya ekleyebileceğini unutmayın.

Aşağıdaki tabloda, özelliklere, yöntemlere veya sisteme göre ayarlanan HTTP üst bilgileri listelenir.

Üstbilgi	Ayar ölçütü
Accept	özelliğine Accept göre ayarlayın.
Connection	özelliğine Connection göre KeepAlive ayarlayın.
Content-Length	özelliğine ContentLength göre ayarlayın.
Content-Type	özelliğine ContentType göre ayarlayın.
Expect	özelliğine Expect göre ayarlayın.
Date	Sistem tarafından geçerli tarihe ayarlanır.
Host	Sistem tarafından geçerli konak bilgilerine ayarlayın.
If-Modified-Since	özelliğine IfModifiedSince göre ayarlayın.
Range	yöntemine göre AddRange ayarlayın.
Referer	özelliğine Referer göre ayarlayın.
Transfer-Encoding	özelliği tarafından TransferEncoding ayarlanır ( SendChunked özelliği olmalıdır true).
User-Agent	özelliğine UserAgent göre ayarlayın.

Not

HttpWebRequest otomatik olarak kaydedilir. veya https://ile http:// başlayan URI'leri kullanmadan önce kaydetmek System.Net.HttpWebRequest için yöntemini çağırmanız RegisterPrefix gerekmez.

Yerel bilgisayar veya uygulama yapılandırma dosyası varsayılan bir ara sunucunun kullanılacağını belirtebilir. Proxy Özellik belirtilirse, özelliğindeki Proxy proxy ayarları yerel bilgisayarı veya uygulama yapılandırma dosyasını geçersiz kılar ve HttpWebRequest örnek belirtilen ara sunucu ayarlarını kullanır. Bir yapılandırma dosyasında proxy belirtilmemişse ve Proxy özelliği belirtilmemişse, HttpWebRequest sınıf yerel bilgisayardaki İnternet seçeneklerinden devralınan ara sunucu ayarlarını kullanır. İnternet seçeneklerinde ara sunucu ayarları yoksa istek doğrudan sunucuya gönderilir.

Not

Framework, ssl oturumlarını oluşturuldukları gibi önbelleğe alır ve mümkünse yeni bir istek için önbelleğe alınmış bir oturumu yeniden kullanma girişiminde bulunur. Bir SSL oturumunu yeniden kullanma girişiminde bulunurken, Framework ilk öğesini ClientCertificates kullanır (varsa) veya boşsa ClientCertificates anonim oturumları yeniden kullanma girişiminde bulunur.

Not

Güvenlik nedeniyle tanımlama bilgileri varsayılan olarak devre dışı bırakılır. Tanımlama bilgilerini kullanmak istiyorsanız, tanımlama bilgilerini etkinleştirmek için özelliğini kullanın CookieContainer .

HttpClient, HttpWebRequest, FTPClient, SmtpClient ve SsStream gibi API'ler aracılığıyla TLS/SSL kullanan uygulamalar için .NET, varsayılan olarak bağlantılar için güvenli olmayan şifreleme ve karma algoritmalarını engeller. Mevcut SSL3 hizmetleri veya RC4 hizmetleriyle birlikte çalışabilirliği sürdürmek için bu davranışı geri çevirmeniz gerekebilir. .NET Framework 4.6'ya yükseltmeden sonra ServicePointManager veya SslStream API'leri kullanılarak sunucuya bağlanılamıyor , gerekirse kodunuzun bu davranışı devre dışı bırakmak için nasıl değiştirileceği açıklanır.

Oluşturucular

Name	Description
HttpWebRequest(SerializationInfo, StreamingContext)	Geçersiz. ve StreamingContext sınıflarının HttpWebRequest belirtilen örneklerinden SerializationInfo sınıfının yeni bir örneğini başlatır. Bu oluşturucu kullanımdan kaldırıldı.

Özellikler

Name	Description
Accept	HTTP üst bilgisinin Accept değerini alır veya ayarlar.
Address	İsteği gerçekten yanıtlayan İnternet kaynağının Tekdüzen Kaynak Tanımlayıcısını (URI) alır.
AllowAutoRedirect	İsteğin yeniden yönlendirme yanıtlarını izlemesi gerekip gerekmediğini belirten bir değer alır veya ayarlar.
AllowReadStreamBuffering	İnternet kaynağından alınan arabelleğe alınıp alınmayacağını belirten bir değer alır veya ayarlar.
AllowWriteStreamBuffering	İnternet kaynağına gönderilen verilerin arabelleğe alınıp alınmayacağını belirten bir değer alır veya ayarlar.
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. (Devralındığı yer: WebRequest)
AutomaticDecompression	Kullanılan sıkıştırma türünü alır veya ayarlar.
CachePolicy	Bu istek için önbellek ilkesini alır veya ayarlar. (Devralındığı yer: WebRequest)
ClientCertificates	Bu istekle ilişkili güvenlik sertifikalarının koleksiyonunu alır veya ayarlar.
Connection	HTTP üst bilgisinin Connection değerini alır veya ayarlar.
ConnectionGroupName	İstek için bağlantı grubunun adını alır veya ayarlar.
ContentLength	HTTP üst bilgisini alır veya ayarlar Content-length .
ContentType	HTTP üst bilgisinin Content-type değerini alır veya ayarlar.
ContinueDelegate	İnternet kaynağından http 100 devam yanıtı alındığında çağrılan temsilci yöntemini alır veya ayarlar.
ContinueTimeout	Sunucudan 100-Continue alınana kadar beklemek için milisaniye cinsinden bir zaman aşımı alır veya ayarlar.
CookieContainer	İstekle ilişkili tanımlama bilgilerini alır veya ayarlar.
Credentials	İstek için kimlik doğrulama bilgilerini alır veya ayarlar.
Date	HTTP isteğinde Date kullanılacak HTTP üst bilgi değerini alır veya ayarlar.
DefaultCachePolicy	Bu istek için varsayılan önbellek ilkesini alır veya ayarlar.
DefaultMaximumErrorResponseLength	HTTP hata yanıtının varsayılan maksimum uzunluğunu alır veya ayarlar.
DefaultMaximumResponseHeadersLength	Özelliği için varsayılanı MaximumResponseHeadersLength alır veya ayarlar.
Expect	HTTP üst bilgisinin Expect değerini alır veya ayarlar.
HaveResponse	Bir İnternet kaynağından yanıt alınıp alınmadığını gösteren bir değer alır.
Headers	HTTP üst bilgilerini oluşturan ad/değer çiftlerinin koleksiyonunu belirtir.
Host	İstek URI'sinden bağımsız bir HTTP isteğinde kullanılacak Konak üst bilgi değerini alır veya ayarlar.
IfModifiedSince	HTTP üst bilgisinin If-Modified-Since değerini alır veya ayarlar.
ImpersonationLevel	Geçerli istek için kimliğe bürünme düzeyini alır veya ayarlar. (Devralındığı yer: WebRequest)
KeepAlive	İnternet kaynağına kalıcı bir bağlantı yapılıp yapılmayacağını belirten bir değer alır veya ayarlar.
MaximumAutomaticRedirections	İsteğin izlediği en fazla yeniden yönlendirme sayısını alır veya ayarlar.
MaximumResponseHeadersLength	Yanıt üst bilgilerinin izin verilen uzunluk üst sınırını alır veya ayarlar.
MediaType	İsteğin medya türünü alır veya ayarlar.
Method	İstek için yöntemini alır veya ayarlar.
Pipelined	İsteğin İnternet kaynağına işlem hattı oluşturup oluşturmayacağını belirten bir değer alır veya ayarlar.
PreAuthenticate	İstekle yetkilendirme üst bilgisinin gönderilip gönderilmeymeyeceğini belirten bir değer alır veya ayarlar.
ProtocolVersion	İstek için kullanılacak HTTP sürümünü alır veya ayarlar.
Proxy	İstek için ara sunucu bilgilerini alır veya ayarlar.
ReadWriteTimeout	Bir akışa yazarken veya akıştan okurken milisaniye cinsinden zaman aşımı alır veya ayarlar.
Referer	HTTP üst bilgisinin Referer değerini alır veya ayarlar.
RequestUri	İsteğin özgün Tekdüzen Kaynak Tanımlayıcısını (URI) alır.
SendChunked	Segmentlerdeki verilerin İnternet kaynağına gönderilip gönderilmeydiğini gösteren bir değer alır veya ayarlar.
ServerCertificateValidationCallback	Sunucu sertifikasını doğrulamak için bir geri çağırma işlevi alır veya ayarlar.
ServicePoint	İstek için kullanılacak hizmet noktasını alır.
SupportsCookieContainer	İsteğin bir için destek sağlayıp sağlamadığını gösteren bir CookieContainerdeğer alır.
Timeout	ve GetRequestStream() yöntemleri için GetResponse() milisaniye cinsinden zaman aşımı değerini alır veya ayarlar.
TransferEncoding	HTTP üst bilgisinin Transfer-encoding değerini alır veya ayarlar.
UnsafeAuthenticatedConnectionSharing	Yüksek hızlı NTLM kimliği doğrulanmış bağlantı paylaşımına izin verilip verilmeyeceğini belirten bir değer alır veya ayarlar.
UseDefaultCredentials	Varsayılan kimlik bilgilerinin isteklerle gönderilip gönderilmediğini denetleyebilen bir Boolean değer alır veya ayarlar.
UserAgent	HTTP üst bilgisinin User-agent değerini alır veya ayarlar.

Yöntemler

Name	Description
Abort()	bir İnternet kaynağına yönelik isteği iptal eder.
AddRange(Int32, Int32)	Belirtilen aralık için isteğe bayt aralığı üst bilgisi ekler.
AddRange(Int32)	İstenen verilerin başından veya sonundan belirli bir aralık için isteğe bayt aralığı üst bilgisi ekler.
AddRange(Int64, Int64)	Belirtilen aralık için isteğe bayt aralığı üst bilgisi ekler.
AddRange(Int64)	İstenen verilerin başından veya sonundan belirli bir aralık için isteğe bayt aralığı üst bilgisi ekler.
AddRange(String, Int32, Int32)	Belirtilen aralık için bir isteğe aralık üst bilgisi ekler.
AddRange(String, Int32)	İstenen verilerin başından veya sonundan belirli bir aralığın isteğine Aralık üst bilgisi ekler.
AddRange(String, Int64, Int64)	Belirtilen aralık için bir isteğe aralık üst bilgisi ekler.
AddRange(String, Int64)	İstenen verilerin başından veya sonundan belirli bir aralığın isteğine Aralık üst bilgisi ekler.
BeginGetRequestStream(AsyncCallback, Object)	Bir nesnenin veri yazmak için kullanması için zaman uyumsuz bir Stream istek başlatır.
BeginGetResponse(AsyncCallback, Object)	İnternet kaynağına zaman uyumsuz bir istek başlatır.
EndGetRequestStream(IAsyncResult, TransportContext)	Bir nesnenin veri yazmak için Stream kullanılabileceği zaman uyumsuz isteği sonlandırır ve akışla ilişkili çıktıları TransportContext alır.
EndGetRequestStream(IAsyncResult)	Bir nesnenin veri yazmak için kullanması için Stream zaman uyumsuz isteği sonlandırır.
EndGetResponse(IAsyncResult)	İnternet kaynağına yönelik zaman uyumsuz bir isteği sonlandı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. hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo .
GetRequestStream()	İstek verilerini yazmak için kullanılacak nesneyi Stream alır.
GetRequestStream(TransportContext)	İstek verilerini yazmak için kullanılacak bir Stream nesnesi alır ve akışla ilişkili çıktıları TransportContext alır.
GetRequestStreamAsync()	Alt sınıfta geçersiz kılındığında, zaman uyumsuz bir işlem olarak İnternet kaynağına veri yazmak için bir döndürür Stream . (Devralındığı yer: WebRequest)
GetResponse()	İnternet kaynağından 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. (Devralındığı yer: WebRequest)
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 nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Geçersiz. hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo .

Ayrıca bkz.

• DefaultProxy Öğesi (Ağ Ayarları)
• Sürüm 3.5 SP1'de HTTPWebRequest için NTLM kimlik doğrulaması değişiklikleri