WebClient.OpenReadTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Otwiera czytelny strumień zawierający określony zasób jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

OpenReadTaskAsync(String)	Otwiera czytelny strumień zawierający określony zasób jako operację asynchroniczną przy użyciu obiektu zadania.
OpenReadTaskAsync(Uri)	Otwiera czytelny strumień zawierający określony zasób jako operację asynchroniczną przy użyciu obiektu zadania.

OpenReadTaskAsync(String)

Źródło:

WebClient.cs

Otwiera czytelny strumień zawierający określony zasób jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);

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

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Parametry

address

String

Identyfikator URI zasobu do pobrania.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca wartość używaną Stream do odczytywania danych z zasobu.

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 operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po otwarciu strumienia z możliwością odczytu do zasobu danych. Ta metoda nie blokuje wywołującego wątku podczas otwierania strumienia.

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.

Uwaga

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

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 .

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 programie .NET Framework.

Zobacz też

• Stream

OpenReadTaskAsync(Uri)

Źródło:

WebClient.cs

Otwiera czytelny strumień zawierający określony zasób jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);

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

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Parametry

address

Uri

Identyfikator URI zasobu do pobrania.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca wartość używaną Stream do odczytywania danych z zasobu.

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 operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po otwarciu strumienia z możliwością odczytu do zasobu danych. Ta metoda nie blokuje wywołującego wątku podczas otwierania strumienia.

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.

Uwaga

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

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 .

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 programie .NET Framework.

Zobacz też

• Stream