WebClient.UploadValuesTaskAsync 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ś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
- Źródło:
- WebClient.cs
- Ź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);
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
Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą odpowiedź wysłaną Byte przez serwer.
- Atrybuty
Wyjątki
Identyfikator URI utworzony przez połączenie elementu 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 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 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, 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 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 programie .NET Framework.
Dotyczy
UploadValuesTaskAsync(String, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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);
[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
Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą odpowiedź wysłaną Byte przez serwer.
- Atrybuty
Wyjątki
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 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, 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 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 programie .NET Framework.
Dotyczy
UploadValuesTaskAsync(Uri, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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);
[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
Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą Byte odpowiedź wysłaną przez serwer.
- Atrybuty
Wyjątki
Identyfikator URI utworzony przez połączenie elementu 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 null
jest i nie application/x-www-form-urlencoded
jest .
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 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, 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 pustym ciągiem, 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 programie .NET Framework.
Dotyczy
UploadValuesTaskAsync(Uri, String, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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);
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
Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą Byte odpowiedź wysłaną przez serwer.
- Atrybuty
Wyjątki
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 lub "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 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, 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 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 programie .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