WebClient.UploadValuesAsync 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 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
- Źródło:
- WebClient.cs
- Ź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
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 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 .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ę .
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 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);
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
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 address
elementu .
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ę .
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 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);
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
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 address
elementu .
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.
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