WebClient.UploadValuesTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadValuesTaskAsync(String, String, NameValueCollection)	Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.
UploadValuesTaskAsync(String, NameValueCollection)	Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.
UploadValuesTaskAsync(Uri, NameValueCollection)	Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.
UploadValuesTaskAsync(Uri, String, NameValueCollection)	Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.

UploadValuesTaskAsync(String, String, NameValueCollection)

Źródło:

WebClient.cs

Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

Parametry

address

String

Identyfikator URI zasobu do odbierania kolekcji.

method

String

Metoda HTTP używana do wysyłania kolekcji do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i stor dla protokołu FTP.

data

NameValueCollection

NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte 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 BaseAddressi 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.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nagłówek Content-type nie jest null ani "application/x-www-form-urlencoded".

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 kolekcji nazwy/wartości do zasobu. Kolekcja nazw/wartości jest wysyłana 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.

Jeśli bazowe żądanie nie jest zrozumiałe dla serwera, klasy protokołów bazowych określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

Jeśli nagłówek Content-type jest null, ta metoda ustawia ją na "application/x-www-form-urlencoded".

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.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

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.

UploadValuesTaskAsync(String, NameValueCollection)

Źródło:

WebClient.cs

Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

Parametry

address

String

Identyfikator URI zasobu do odbierania kolekcji.

data

NameValueCollection

NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte 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 BaseAddressi address jest nieprawidłowy.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nagłówek Content-type nie jest null ani "application/x-www-form-urlencoded".

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 kolekcji nazwy/wartości do zasobu. Kolekcja nazw/wartości jest wysyłana 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.

Jeśli bazowe żądanie nie jest zrozumiałe dla serwera, klasy protokołów bazowych określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

Jeśli nagłówek Content-type jest null, ta metoda ustawia ją na "application/x-www-form-urlencoded".

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.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

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.

UploadValuesTaskAsync(Uri, NameValueCollection)

Źródło:

WebClient.cs

Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

Parametry

address

Uri

Identyfikator URI zasobu do odbierania kolekcji.

data

NameValueCollection

NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte 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 BaseAddressi address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

Wartość nagłówka Content-type nie jest null i nie jest application/x-www-form-urlencoded.

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 kolekcji nazwy/wartości do zasobu. Kolekcja nazw/wartości jest wysyłana 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.

Jeśli bazowe żądanie nie jest zrozumiałe dla serwera, klasy protokołów bazowych określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

Jeśli nagłówek Content-type jest null, ta metoda ustawia ją na "application/x-www-form-urlencoded".

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.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

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.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Źródło:

WebClient.cs

Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

Parametry

address

Uri

Identyfikator URI zasobu do odbierania kolekcji.

method

String

Metoda HTTP używana do wysyłania kolekcji do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i stor dla protokołu FTP.

data

NameValueCollection

NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte 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 BaseAddressi 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.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nagłówek Content-type nie jest null ani "application/x-www-form-urlencoded".

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 kolekcji nazwy/wartości do zasobu. Kolekcja nazw/wartości jest wysyłana 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.

Jeśli bazowe żądanie nie jest zrozumiałe dla serwera, klasy protokołów bazowych określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

Jeśli nagłówek Content-type jest null, ta metoda ustawia ją na "application/x-www-form-urlencoded".

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.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

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.