HttpClient.GetStreamAsync Yöntem

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Http.dll

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.

Aşırı Yüklemeler

Name	Description
GetStreamAsync(Uri, CancellationToken)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.
GetStreamAsync(String, CancellationToken)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.
GetStreamAsync(Uri)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.
GetStreamAsync(String)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.

Açıklamalar

İşlem engellenmez.

GetStreamAsync(Uri, CancellationToken)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Stream)

Parametreler

requestUri

Uri

İsteğin gönderildiği URI.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<Stream>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

requestUri şudur: null.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

-veya-

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

Açıklamalar

Bu işlem engellemez. Yanıt üst bilgileri okunduktan sonra döndürülen Görev<Akışı> nesnesi tamamlanır. Bu yöntem yanıt gövdesini okumaz veya arabelleğe almaz. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir OperationCanceledException iç içe yerleştiren bir TimeoutException oluşturur.

GetStreamAsync(String, CancellationToken)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Stream)

Parametreler

requestUri

String

İsteğin gönderildiği URI.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<Stream>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

-veya-

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

ArgumentNullException

requestUri şudur: null.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

UriFormatException

Sağlanan istek URI'si geçerli göreli veya mutlak URI değil.

Açıklamalar

Bu işlem engellemez. Yanıt üst bilgileri okunduktan sonra döndürülen Görev<Akışı> nesnesi tamamlanır. Bu yöntem yanıt gövdesini okumaz veya arabelleğe almaz. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve sonraki sürümler, TimeoutException iç içe yerleştiren bir OperationCanceledException oluşturur.

GetStreamAsync(Uri)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(Uri? requestUri);

member this.GetStreamAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri) As Task(Of Stream)

Parametreler

requestUri

Uri

İsteğin gönderildiği URI.

Döndürülenler

Task<Stream>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

InvalidOperationException

requestUri mutlak bir URI değildir ve BaseAddress ayarlanmaz.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

-veya-

Yalnızca .NET Framework: İstek zaman aşımına uğradı.

OperationCanceledException

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

Açıklamalar

Bu işlem engellemez. Yanıt üst bilgileri okunduktan sonra döndürülen Görev<Akışı> nesnesi tamamlanır. Bu yöntem yanıt gövdesini okumaz veya arabelleğe almaz. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir OperationCanceledException iç içe yerleştiren bir TimeoutException oluşturur.

GetStreamAsync(String)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini akış olarak döndürün.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(string? requestUri);

member this.GetStreamAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String) As Task(Of Stream)

Parametreler

requestUri

String

İsteğin gönderildiği URI.

Döndürülenler

Task<Stream>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

InvalidOperationException

requestUri mutlak bir URI değildir ve BaseAddress ayarlanmaz.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

-veya-

Yalnızca .NET Framework: İstek zaman aşımına uğradı.

OperationCanceledException

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

UriFormatException

Sağlanan istek URI'si geçerli göreli veya mutlak URI değil.

Açıklamalar

Bu işlem engellemez. Yanıt üst bilgileri okunduktan sonra döndürülen Görev<Akışı> nesnesi tamamlanır. Bu yöntem yanıt gövdesini okumaz veya arabelleğe almaz. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir OperationCanceledException iç içe yerleştiren bir TimeoutException oluşturur.