WebClient.OpenReadAsync Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.WebClient.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Otwiera czytelny strumień zawierający określony zasób. Te metody nie blokują wątku wywołującego.

Przeciążenia

OpenReadAsync(Uri)

Otwiera czytelny strumień zawierający określony zasób. Ta metoda nie blokuje wątku wywołującego.
OpenReadAsync(Uri, Object)

Otwiera czytelny strumień zawierający określony zasób. Ta metoda nie blokuje wątku wywołującego.

OpenReadAsync(Uri)

Otwiera czytelny strumień zawierający określony zasób. Ta metoda nie blokuje wątku wywołującego.

public:
 void OpenReadAsync(Uri ^ address);
public void OpenReadAsync (Uri address);
member this.OpenReadAsync : Uri -> unit
Public Sub OpenReadAsync (address As Uri)

Parametry

address
Uri

Identyfikator URI zasobu do pobrania.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i adres jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Ta metoda pobiera Stream wystąpienie używane do uzyskiwania dostępu do zasobu określonego address przez parametr . Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia, gdy strumień jest dostępny, dodaj do zdarzenia program obsługi zdarzeń OpenReadCompleted .

Uwaga

Po zakończeniu należy wywołać Stream.Close metodę , Stream aby uniknąć wyczerpania zasobów systemowych.

Ta metoda nie blokuje wywołującego wątku podczas otwierania strumienia. Aby zablokować podczas oczekiwania na strumień, użyj OpenReadAsync metody .

W .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync .

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie określa bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanego zasobu. QueryString Jeśli właściwość nie nullma wartości , jest dołączana do addresselementu .

Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez OpenRead(Uri)usługę .

Dotyczy

OpenReadAsync(Uri, Object)

Otwiera czytelny strumień zawierający określony zasób. Ta metoda nie blokuje wątku wywołującego.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);
public void OpenReadAsync (Uri address, object? userToken);
public void OpenReadAsync (Uri address, object userToken);
member this.OpenReadAsync : Uri * obj -> unit
Public Sub OpenReadAsync (address As Uri, userToken As Object)

Parametry

address
Uri

Identyfikator URI zasobu do pobrania.

userToken
Object

Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i adres jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Ta metoda pobiera Stream wystąpienie używane do uzyskiwania dostępu do zasobu określonego address przez parametr . Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia, gdy strumień jest dostępny, dodaj do zdarzenia program obsługi zdarzeń OpenReadCompleted .

Uwaga

Po zakończeniu należy wywołać Stream.Close metodę , Stream aby uniknąć wyczerpania zasobów systemowych.

Ta metoda nie blokuje wywołującego wątku podczas otwierania strumienia. Aby zablokować podczas oczekiwania na strumień, użyj OpenRead metody .

W .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync .

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie określa bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanego zasobu. QueryString Jeśli właściwość nie nullma wartości , jest dołączana do addresselementu .

Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy