WebClient.UploadStringTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadStringTaskAsync(Uri, String, String)	Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
UploadStringTaskAsync(String, String, String)	Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
UploadStringTaskAsync(String, String)	Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
UploadStringTaskAsync(Uri, String)	Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

UploadStringTaskAsync(Uri, String, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string? method, string data);

member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of 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.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca String zawierającą odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

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

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu ciągu 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.

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.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

UploadStringTaskAsync(String, String, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string? method, string data);

member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)

Parametry

address

String

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.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca String zawierającą odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

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

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu ciągu 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.

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.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

UploadStringTaskAsync(String, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Parametry

address

String

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.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca String zawierającą odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu ciągu 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.

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.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

UploadStringTaskAsync(Uri, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of 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.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca String zawierającą odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu ciągu 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.

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.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.