WebClient.UploadStringAsync 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.
Przekazuje określony ciąg do określonego zasobu. Te metody nie blokują wątku wywołującego.
Przeciążenia
UploadStringAsync(Uri, String) |
Przekazuje określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego. |
UploadStringAsync(Uri, String, String) |
Przekazuje określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego. |
UploadStringAsync(Uri, String, String, Object) |
Przekazuje określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego. |
UploadStringAsync(Uri, String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego.
public:
void UploadStringAsync(Uri ^ address, System::String ^ data);
public void UploadStringAsync (Uri address, string data);
member this.UploadStringAsync : Uri * string -> unit
Public Sub UploadStringAsync (address As Uri, data As String)
Parametry
- address
- Uri
Identyfikator URI zasobu do odbierania ciągu. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą metody POST, na przykład skryptu lub strony ASP.
- data
- String
Ciąg, który ma zostać przekazany.
Wyjątki
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
Uwagi
Ta metoda wysyła ciąg do zasobu. Ciąg jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego Encoding we właściwości . Aby otrzymywać powiadomienie po zakończeniu przekazywania ciągu, możesz dodać do zdarzenia program obsługi zdarzeń UploadStringCompleted .
Ta metoda nie blokuje wywołującego wątku podczas wysyłania ciągu. Aby wysłać ciąg i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadString metod.
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 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 STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.
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 UploadString(Uri, String)usługę .
Dotyczy
UploadStringAsync(Uri, String, String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego.
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);
public void UploadStringAsync (Uri address, string? method, string data);
public void UploadStringAsync (Uri address, string method, string data);
member this.UploadStringAsync : Uri * string * string -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String)
Parametry
- address
- Uri
Identyfikator URI zasobu do odbierania ciągu. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą metody POST, na przykład skryptu lub strony ASP.
- method
- String
Metoda HTTP używana do wysyłania pliku do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.
- data
- String
Ciąg, który ma zostać przekazany.
Wyjątki
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
method
Nie można użyć do wysyłania zawartości.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
Uwagi
Ta metoda wysyła ciąg do zasobu. Ciąg jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego Encoding we właściwości . Aby otrzymywać powiadomienie po zakończeniu przekazywania ciągu, możesz dodać do zdarzenia program obsługi zdarzeń UploadStringCompleted .
Ta metoda nie blokuje wywołującego wątku podczas wysyłania ciągu. Aby wysłać ciąg i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadString metod.
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 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 .
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 UploadString(Uri, String, String)usługę .
Dotyczy
UploadStringAsync(Uri, String, String, Object)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego.
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);
public void UploadStringAsync (Uri address, string? method, string data, object? userToken);
public void UploadStringAsync (Uri address, string method, string data, object userToken);
member this.UploadStringAsync : Uri * string * string * obj -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)
Parametry
- address
- Uri
Identyfikator URI zasobu do odbierania ciągu. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą metody POST, na przykład skryptu lub strony ASP.
- method
- String
Metoda HTTP używana do wysyłania pliku do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.
- data
- String
Ciąg, który ma zostać przekazany.
- userToken
- Object
Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.
Wyjątki
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
method
Nie można użyć do wysyłania zawartości.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
Uwagi
Ta metoda wysyła ciąg do zasobu. Ciąg jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego Encoding we właściwości . Aby otrzymywać powiadomienie po zakończeniu przekazywania ciągu, możesz dodać do zdarzenia program obsługi zdarzeń UploadStringCompleted .
Ta metoda nie blokuje wywołującego wątku podczas wysyłania ciągu. Aby wysłać ciąg i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadString metod.
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 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 pustym ciągiem, jest dołączana do address
elementu .
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
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