WebClient.UploadDataAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI. Ta metoda nie blokuje wątku wywołującego.

Przeciążenia

UploadDataAsync(Uri, String, Byte[])	Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu określonej metody. Ta metoda nie blokuje wątku wywołującego.
UploadDataAsync(Uri, String, Byte[], Object)	Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu określonej metody i identyfikacji tokenu.
UploadDataAsync(Uri, Byte[])	Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.

UploadDataAsync(Uri, String, Byte[])

Źródło:

WebClient.cs

Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu określonej metody. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As 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.

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 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. Aby otrzymywać powiadomienia po zakończeniu przekazywania danych, dodaj do zdarzenia program obsługi zdarzeń UploadDataCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania danych. Aby wysłać dane i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadData metod.

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 połączonym address z elementem 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.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez UploadData(Uri, String, Byte[])usługę .

UploadDataAsync(Uri, String, Byte[], Object)

Źródło:

WebClient.cs

Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu określonej metody i identyfikacji tokenu.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

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.

userToken

Object

Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.

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 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. Aby otrzymywać powiadomienia po zakończeniu przekazywania danych, dodaj do zdarzenia program obsługi zdarzeń UploadDataCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania danych. Aby wysłać dane i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadData metod.

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 połączonym address z elementem 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.

UploadDataAsync(Uri, Byte[])

Źródło:

WebClient.cs

Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

data

Byte[]

Bufor danych do wysłania do zasobu.

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 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. Aby otrzymywać powiadomienia po zakończeniu przekazywania danych, dodaj do zdarzenia program obsługi zdarzeń UploadDataCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania danych. Aby wysłać dane i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadData metod.

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 połączonym address z elementem 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.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez UploadData(Uri, Byte[])usługę .