WebRequest Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Tekdüzen Kaynak Tanımlayıcısı'na (URI) istekte bulunur. Bu bir abstract
sınıf.
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
- Devralma
-
WebRequest
- Devralma
- Türetilmiş
- Öznitelikler
- Uygulamalar
Örnekler
Aşağıdaki örnekte bir WebRequest örneğin nasıl oluşturulacağı ve yanıtın nasıl döndürüleceği 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
Önemli
Yeni geliştirme için veya türetilmiş sınıflarını kullanmayın WebRequest
. Bunun yerine sınıfını System.Net.Http.HttpClient kullanın.
WebRequest
abstract
, için temel sınıftır. NET'in İnternet'ten verilere erişmek iç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 sınıfın WebRequest ö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 alt öğeler listesinden WebRequest oluşturulacak uygun alt sınıfı belirler. WebRequest alt öğeler 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.
Sınıfı, WebRequest bir İnternet kaynağına erişirken hatalar oluştuğunda bir oluşturur WebException . Status özelliği, hatanın WebExceptionStatus kaynağını gösteren değerlerden biridir. olduğunda StatusWebExceptionStatus.ProtocolError, Response özelliği İnternet kaynağından alınan öğesini içerir WebResponse .
WebRequest sınıfı bir abstract
sınıf olduğundan, çalışma zamanında örneklerin WebRequest gerçek davranışı yöntemi tarafından döndürülen alt sınıf tarafından Create belirlenir. Varsayılan değerler ve özel durumlar hakkında daha fazla bilgi için ve FileWebRequestgibi HttpWebRequest alt sınıfların belgelerine bakın.
Not
Create Yeni WebRequest örnekleri başlatmak için yöntemini kullanın. Oluşturucuyu WebRequest 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
'den WebRequestdevraldığınızda, şu üyeleri geçersiz kılmalısınız: Method, RequestUri, Headers, ContentLength, ContentType, , CredentialsPreAuthenticate, , GetRequestStream()BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)ve EndGetResponse(IAsyncResult). Ayrıca, çağırdığınızda Create(Uri)kullanılan yöntemi tanımlayan Create(Uri) arabiriminin IWebRequestCreate bir uygulamasını sağlamanız gerekir. yöntemini veya yapılandırma dosyasını kullanarak RegisterPrefix(String, IWebRequestCreate) arabirimini uygulayan IWebRequestCreate 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.
ve StreamingContext sınıflarının WebRequest belirtilen örneklerinden sınıfının yeni bir örneğini SerializationInfo başlatır. |
Özellikler
AuthenticationLevel |
Bu istek için kullanılan kimlik doğrulama 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. |
CreatorInstance |
Geçersiz.
Bir alt sınıfta geçersiz kılındığında, belirtilen URI'ye istekte bulunmak için örneği oluşturulmuş oluşturmak WebRequest için kullanılan sınıftan türetilen IWebRequestCreate fabrika nesnesini alır. |
Credentials |
Alt sınıfta geçersiz kılındığında, isteğin İnternet kaynağıyla kimliğini 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 |
Bir 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ğ proxy'sini alır veya ayarlar. |
RequestUri |
Bir 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, isteklerle gönderilip gönderilmeydiğini DefaultCredentials denetleyen bir Boolean değer alır veya ayarlar. |
Yöntemler
Abort() |
İsteği durdurur. |
BeginGetRequestStream(AsyncCallback, Object) |
Bir alt sınıfta geçersiz kılındığında yönteminin zaman uyumsuz bir sürümünü GetRequestStream() sağlar. |
BeginGetResponse(AsyncCallback, Object) |
Bir alt sınıfta geçersiz kılındığında, İnternet kaynağı için zaman uyumsuz bir istek başlatır. |
Create(String) |
Geçersiz.
Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır. |
Create(Uri) |
Geçersiz.
Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır. |
CreateDefault(Uri) |
Geçersiz.
Belirtilen URI düzeni için yeni WebRequest bir örnek başlatır. |
CreateHttp(String) |
Geçersiz.
Belirtilen URI dizesi için yeni HttpWebRequest bir örnek başlatır. |
CreateHttp(Uri) |
Geçersiz.
Belirtilen URI için yeni HttpWebRequest bir örnek 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) |
Bir 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.
hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo . |
GetRequestStream() |
Bir alt sınıfta geçersiz kılındığında, İnternet kaynağına veri yazmak için bir Stream döndürür. |
GetRequestStreamAsync() |
Bir 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 . |
GetResponse() |
Bir alt sınıfta geçersiz kılındığında, İnternet isteğine bir yanıt döndürür. |
GetResponseAsync() |
Bir 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() |
Type Geçerli örneğini 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 Objectöğesinin sığ 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) |
RegisterPortableWebRequestCreator(IWebRequestCreate) |
Geçersiz.
Bir IWebRequestCreate nesneyi kaydetme. |
RegisterPrefix(String, IWebRequestCreate) |
Belirtilen URI için bir WebRequest alt öğe kaydeder. |
ToString() |
Geçerli nesneyi temsil eden dizeyi 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, örneğini SerializationInfo seri hale WebRequestgetirmek için gereken verilerle doldurur. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin