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 określonego identyfikatora 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 zidentyfikowanych 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 zidentyfikowanych 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 zidentyfikowanych 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ącego 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 zidentyfikowanych 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
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 ją 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ć procedurę obsługi zdarzeń UploadStringCompleted do zdarzenia.
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 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 pustym ciągiem, 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 przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane 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 zidentyfikowanych 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ą 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żywać do wysyłania zawartości.
Uwagi
Ta metoda wysyła dane zawarte w zasobie NameValueCollectionaddress
. 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 formularza; 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 wartość w przypadku wywołania tej metody z inną wartością nagłówka Typu zawartości ustawioną w kolekcji Headers .
method
Jeśli metoda nie jest zrozumiała dla serwera, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.
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ć powiadomienie po zakończeniu operacji przekazywania, dodaj procedurę obsługi zdarzeń UploadValuesCompleted do zdarzenia.
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 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 przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane 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 zidentyfikowanych 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ącego 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ą 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 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żywać do wysyłania zawartości.
Uwagi
Ta metoda wysyła dane zawarte w zasobie NameValueCollectionaddress
. 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 formularza; 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 wartość w przypadku wywołania tej metody z inną wartością nagłówka Typu zawartości ustawioną w kolekcji Headers .
method
Jeśli metoda nie jest zrozumiała dla serwera, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.
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ć powiadomienie po zakończeniu operacji przekazywania, dodaj procedurę obsługi zdarzeń UploadValuesCompleted do zdarzenia.
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 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