WebClient.OpenReadAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.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)

Źródło:

WebClient.cs

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 jest 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

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda pobiera wystąpienie Stream używane do uzyskiwania dostępu do zasobu określonego przez parametr address. 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 program obsługi zdarzeń do zdarzenia OpenReadCompleted.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć wyczerpania zasobów systemowych.

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

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

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

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez OpenRead(Uri).

OpenReadAsync(Uri, Object)

Źródło:

WebClient.cs

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);

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 jest 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

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda pobiera wystąpienie Stream używane do uzyskiwania dostępu do zasobu określonego przez parametr address. 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 program obsługi zdarzeń do zdarzenia OpenReadCompleted.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć wyczerpania zasobów systemowych.

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

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

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

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.