WebClient.DownloadStringAsync 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.
Przeciążenia
DownloadStringAsync(Uri) |
Pobiera zasób określony jako Uri. Ta metoda nie blokuje wątku wywołującego. |
DownloadStringAsync(Uri, Object) |
Pobiera określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego. |
DownloadStringAsync(Uri)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera zasób określony jako Uri. Ta metoda nie blokuje wątku wywołującego.
public:
void DownloadStringAsync(Uri ^ address);
public void DownloadStringAsync (Uri address);
member this.DownloadStringAsync : Uri -> unit
Public Sub DownloadStringAsync (address As Uri)
Parametry
Wyjątki
Parametr address
ma wartość null
.
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania zasobu.
Uwagi
Zasób jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
Po pobraniu zasobu ta metoda używa kodowania określonego Encoding we właściwości , aby przekonwertować zasób na String. Ta metoda nie blokuje wywołującego wątku podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj DownloadString metody . Po zakończeniu pobierania zostanie DownloadStringCompleted zgłoszone zdarzenie. Aplikacja musi obsługiwać to zdarzenie, aby otrzymywać powiadomienia. Pobrany ciąg jest dostępny we Result właściwości .
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 zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych.
QueryString Jeśli właściwość nie jest ciągiem pustym, 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 DownloadString(Uri)usługę .
Dotyczy
DownloadStringAsync(Uri, Object)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego.
public:
void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadStringAsync (Uri address, object? userToken);
public void DownloadStringAsync (Uri address, object userToken);
member this.DownloadStringAsync : Uri * obj -> unit
Public Sub DownloadStringAsync (address As Uri, userToken As Object)
Parametry
- 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 address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania zasobu.
Uwagi
Zasób jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
Po pobraniu zasobu ta metoda używa kodowania określonego Encoding we właściwości , aby przekonwertować zasób na String. Ta metoda nie blokuje wywołującego wątku podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj DownloadString metody . Po zakończeniu pobierania zostanie DownloadStringCompleted zgłoszone zdarzenie. Aplikacja musi obsługiwać to zdarzenie, aby otrzymywać powiadomienia. Pobrany ciąg jest dostępny we Result właściwości .
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 zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych.
QueryString Jeśli właściwość nie jest ciągiem pustym, 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