WebClient.UploadStringAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

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

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 zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

data

String

Ciąg do przekazania.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

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 ją 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ć procedurę obsługi zdarzeń UploadStringCompleted do zdarzenia.

Ta metoda nie blokuje wątku wywołującego 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 addresselementu .

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 przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez UploadString(Uri, String)usługę .

UploadStringAsync(Uri, String, String)

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

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 zidentyfikować zasób, który może zaakceptować żądanie wysł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 do przekazania.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

method nie można używać 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 ją 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ć procedurę obsługi zdarzeń UploadStringCompleted do zdarzenia.

Ta metoda nie blokuje wątku wywołującego 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 addresselementu .

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 przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez UploadString(Uri, String, String)usługę .

UploadStringAsync(Uri, String, String, Object)

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

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 zidentyfikować zasób, który może zaakceptować żądanie wysł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 do przekazania.

userToken

Object

Obiekt zdefiniowany przez użytkownika przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

method nie można używać 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 ją 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ć procedurę obsługi zdarzeń UploadStringCompleted do zdarzenia.

Ta metoda nie blokuje wątku wywołującego 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 addresselementu .

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.