WebClient.UploadDataTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadDataTaskAsync(String, Byte[])	Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.
UploadDataTaskAsync(Uri, Byte[])	Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.
UploadDataTaskAsync(String, String, Byte[])	Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.
UploadDataTaskAsync(Uri, String, Byte[])	Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

UploadDataTaskAsync(String, Byte[])

Źródło:

WebClient.cs

Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);

member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

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

Parametry

address

String

Identyfikator URI zasobu do odbierania danych.

data

Byte[]

Bufor danych 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 treść odpowiedzi otrzymanej z zasobu podczas przekazywania buforu danych.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

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

-lub-

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu buforu danych do zasobu.

Ta metoda wysyła bufor danych do zasobu. Bufor danych jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Dane nie są kodowane.

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, address który jest połączony 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.

UploadDataTaskAsync(Uri, Byte[])

Źródło:

WebClient.cs

Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);

member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

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

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

data

Byte[]

Bufor danych 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 treść odpowiedzi otrzymanej z zasobu podczas przekazywania buforu danych.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

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

-lub-

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu buforu danych do zasobu.

Ta metoda wysyła bufor danych do zasobu. Bufor danych jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Dane nie są kodowane.

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, address który jest połączony 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.

UploadDataTaskAsync(String, String, Byte[])

Źródło:

WebClient.cs

Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

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

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

member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

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

Parametry

address

String

Identyfikator URI zasobu do odbierania danych.

method

String

Metoda używana do wysyłania danych do zasobu. Jeśli nullwartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.

data

Byte[]

Bufor danych 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 treść odpowiedzi otrzymanej z zasobu podczas przekazywania buforu danych.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

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

-lub-

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu buforu danych do zasobu.

Ta metoda wysyła bufor danych do zasobu. Bufor danych jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Dane nie są kodowane.

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, address który jest połączony 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 .

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.

UploadDataTaskAsync(Uri, String, Byte[])

Źródło:

WebClient.cs

Przekazuje bufor danych zawierający tablicę Byte do identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

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

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

member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

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

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

method

String

Metoda używana do wysyłania danych do zasobu. Jeśli nullwartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.

data

Byte[]

Bufor danych 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 treść odpowiedzi otrzymanej z zasobu podczas przekazywania buforu danych.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

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

-lub-

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po przekazaniu buforu danych do zasobu.

Ta metoda wysyła bufor danych do zasobu. Bufor danych jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Dane nie są kodowane.

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, address który jest połączony 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 .

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.