Udostępnij za pośrednictwem

WebClient.UploadValuesAsync 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 określonego identyfikatora URI. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadValuesAsync(Uri, NameValueCollection)

Przekazuje dane w określonej kolekcji nazwa/wartość do zasobu zidentyfikowanym przez określony identyfikator URI. Ta metoda nie blokuje wątku wywołującego.
UploadValuesAsync(Uri, String, NameValueCollection)

Przekazuje dane w określonej kolekcji nazwy/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 nazwy/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 i umożliwia obiektowi wywołującym przekazanie obiektu do metody wywoływanej po zakończeniu operacji.

UploadValuesAsync(Uri, NameValueCollection)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Źródło:
WebClient.cs

Przekazuje dane w określonej kolekcji nazwa/wartość do zasobu zidentyfikowanym 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 zidentyfikować zasób, który może zaakceptować żądanie wysłane przy użyciu metody domyślnej.

data
NameValueCollection

NameValueCollection do wysłania do zasobu.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

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 we właściwości Encoding. Aby otrzymywać powiadomienie po zakończeniu przekazywania ciągu, można dodać program obsługi zdarzeń do zdarzenia UploadStringCompleted.

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

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 właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez UploadValues(Uri, NameValueCollection).

Dotyczy

UploadValuesAsync(Uri, String, NameValueCollection)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Źródło:
WebClient.cs

Przekazuje dane w określonej kolekcji nazwy/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);
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 zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody method.

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

NameValueCollection do wysłania do zasobu.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest 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

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda wysyła dane zawarte w NameValueCollection do zasobu address. Ta metoda służy do wysyłania danych formularza do identyfikatora URI na potrzeby przetwarzania. Dane są wysyłane przy użyciu typu nośnika zakodowanego w formacie form; 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, jeśli wywołasz tę metodę z inną wartością nagłówka Content-Type ustawioną w kolekcji Headers.

Jeśli metoda method nie jest rozumiana przez serwer, podstawowe klasy protokołów określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

NameValueCollection jest wysyłana 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 procedurę obsługi zdarzeń do zdarzenia UploadValuesCompleted.

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

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 właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pusta, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez UploadValues(Uri, String, NameValueCollection).

Dotyczy

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Źródło:
WebClient.cs

Przekazuje dane w określonej kolekcji nazwy/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 i umożliwia obiektowi 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);
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 zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody method.

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

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

-lub-

Parametr data jest 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

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda wysyła dane zawarte w NameValueCollection do zasobu address. Ta metoda służy do wysyłania danych formularza do identyfikatora URI na potrzeby przetwarzania. Dane są wysyłane przy użyciu typu nośnika zakodowanego w formacie form; 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, jeśli wywołasz tę metodę z inną wartością nagłówka Content-Type ustawioną w kolekcji Headers.

Jeśli metoda method nie jest rozumiana przez serwer, podstawowe klasy protokołów określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

NameValueCollection jest wysyłana 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 procedurę obsługi zdarzeń do zdarzenia UploadValuesCompleted.

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

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 właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pusta, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Dotyczy