WebClient.UploadValuesAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadValuesAsync(Uri, NameValueCollection)	Przekazuje dane w określonej kolekcji nazw/wartości do zasobu określonego przez określony identyfikator URI. Ta metoda nie blokuje wątku wywołującego.
UploadValuesAsync(Uri, String, NameValueCollection)	Przekazuje dane w określonej kolekcji nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI przy użyciu określonej metody. Ta metoda nie blokuje wątku wywołującego.
UploadValuesAsync(Uri, String, NameValueCollection, Object)	Przekazuje dane w określonej kolekcji nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI przy użyciu określonej metody. Ta metoda nie blokuje wywołującego wątku i umożliwia wywołującym przekazanie obiektu do metody wywoływanej po zakończeniu operacji.

UploadValuesAsync(Uri, NameValueCollection)

Źródło:

WebClient.cs

Przekazuje dane w określonej kolekcji nazw/wartości do zasobu określonego przez określony identyfikator URI. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania kolekcji. Ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane przy użyciu metody domyślnej.

data

NameValueCollection

Element NameValueCollection do wysłania do zasobu.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

-lub-

Parametr data ma wartość null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ta metoda wysyła ciąg do zasobu. Ciąg jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego Encoding we właściwości . Aby otrzymywać powiadomienie po zakończeniu przekazywania ciągu, możesz dodać do zdarzenia program obsługi zdarzeń UploadStringCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania ciągu. Aby wysłać ciąg i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadString 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 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 UploadValues(Uri, NameValueCollection)usługę .

UploadValuesAsync(Uri, String, NameValueCollection)

Źródło:

WebClient.cs

Przekazuje dane w określonej kolekcji nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI przy użyciu określonej metody. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania kolekcji. Ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą method metody .

method

String

Metoda używana do wysyłania ciągu 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.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

-lub-

Parametr data ma wartość null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

method Nie można użyć do wysyłania zawartości.

Uwagi

Ta metoda wysyła dane zawarte w obiekcie NameValueCollectionaddress do zasobu. Ta metoda służy do wysyłania danych formularza do identyfikatora URI do przetwarzania. Dane są wysyłane przy użyciu typu nośnika zakodowanego w postaci adresu URL; Wartość nagłówka Content-Type musi być ustawiona na wartość "application/x-www-form-urlencoded". Nagłówek jest domyślnie ustawiony poprawnie. Metody UploadValuesAsync zgłaszają WebException wyjątek , jeśli wywołasz tę metodę z inną wartością nagłówka Content-Type ustawioną w kolekcji Headers .

method Jeśli metoda nie jest rozumiana przez serwer, 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.

Element NameValueCollection jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia po zakończeniu operacji przekazywania, dodaj do zdarzenia program obsługi zdarzeń UploadValuesCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania ciągu. Aby wysłać ciąg i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadValues 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 BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest pusta, 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 UploadValues(Uri, String, NameValueCollection)usługę .

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Źródło:

WebClient.cs

Przekazuje dane w określonej kolekcji nazw/wartości do zasobu zidentyfikowanego przez określony identyfikator URI przy użyciu określonej metody. Ta metoda nie blokuje wywołującego wątku i umożliwia wywołującym przekazanie obiektu do metody wywoływanej po zakończeniu operacji.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);

public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania kolekcji. Ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą method metody .

method

String

Metoda HTTP używana do wysyłania ciągu 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.

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.

-lub-

Parametr data ma wartość null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

method Nie można użyć do wysyłania zawartości.

Uwagi

Ta metoda wysyła dane zawarte w obiekcie NameValueCollectionaddress do zasobu. Ta metoda służy do wysyłania danych formularza do identyfikatora URI do przetwarzania. Dane są wysyłane przy użyciu typu nośnika zakodowanego w postaci adresu URL; Wartość nagłówka Content-Type musi być ustawiona na wartość "application/x-www-form-urlencoded". Nagłówek jest domyślnie ustawiony poprawnie. Metody UploadValuesAsync zgłaszają WebException wyjątek , jeśli wywołasz tę metodę z inną wartością nagłówka Content-Type ustawioną w kolekcji Headers .

method Jeśli metoda nie jest rozumiana przez serwer, 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.

Element NameValueCollection jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia po zakończeniu operacji przekazywania, dodaj do zdarzenia program obsługi zdarzeń UploadValuesCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania ciągu. Aby wysłać ciąg i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadValues 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 BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest pusta, 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.