WebClient.UploadDataAsync 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 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 identyfikowania 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
- Źródło:
- WebClient.cs
- Ź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);
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 null
wartość 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
Parametr address
to null
.
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ą zakodowane. Aby otrzymywać powiadomienie po zakończeniu przekazywania danych, dodaj procedurę obsługi zdarzeń UploadDataCompleted do zdarzenia.
Ta metoda nie blokuje wątku wywołującego 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 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 .
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 UploadData(Uri, String, Byte[])usługę .
Dotyczy
UploadDataAsync(Uri, String, Byte[], Object)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje bufor danych do zasobu zidentyfikowanego przez identyfikator URI przy użyciu określonej metody i identyfikowania 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);
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 null
wartość 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 przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.
Wyjątki
Parametr address
to null
.
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ą zakodowane. Aby otrzymywać powiadomienie po zakończeniu przekazywania danych, dodaj procedurę obsługi zdarzeń UploadDataCompleted do zdarzenia.
Ta metoda nie blokuje wątku wywołującego 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 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 .
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
UploadDataAsync(Uri, Byte[])
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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
Parametr address
to null
.
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ą zakodowane. Aby otrzymywać powiadomienie po zakończeniu przekazywania danych, dodaj procedurę obsługi zdarzeń UploadDataCompleted do zdarzenia.
Ta metoda nie blokuje wątku wywołującego 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 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 UploadData(Uri, Byte[])usługę .
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