WebClient.OpenReadAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Źródło:
- WebClient.cs
- Ź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
Parametr address
ma wartość null
.
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 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 null
ma wartości , jest dołączana do address
elementu .
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.
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)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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);
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
Parametr address
ma wartość null
.
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 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 null
ma wartości , jest dołączana do address
elementu .
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.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla