WebClient.UploadValuesTaskAsync Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.WebClient.dll
Zestaw:
System.dll
Zestaw:
netstandard.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)

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);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string method, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
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[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Element NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

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

Atrybuty
ComVisibleAttribute

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu 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.

-lub-

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

-lub-

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

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu kolekcji nazw/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 .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, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.

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

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.

Dotyczy

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.

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);
[System.Runtime.InteropServices.ComVisible(false)]
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[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Element NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

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

Atrybuty
ComVisibleAttribute

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

-lub-

Parametr data ma wartość null.

WebException

Identyfikator URI utworzony przez połączenie elementu 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 null jest ani "application/x-www-form-urlencoded".

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> 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 .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, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj obiekt jest zgłaszany z właściwością ustawioną w Status celu wskazania błędu.

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

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 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.

Dotyczy

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.

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);
[System.Runtime.InteropServices.ComVisible(false)]
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[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Element NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

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

Atrybuty
ComVisibleAttribute

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu i 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 null jest i nie application/x-www-form-urlencodedjest .

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu kolekcji nazw/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 .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, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.

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

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.

Dotyczy

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.

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);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
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[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Element NameValueCollection do wysłania do zasobu.

Zwraca

Task<Byte[]>

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

Atrybuty
ComVisibleAttribute

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddresselementu 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.

-lub-

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

-lub-

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

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu kolekcji nazw/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 .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, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.

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

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.

Dotyczy