WebClient.UploadFileTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadFileTaskAsync(Uri, String, String)	Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
UploadFileTaskAsync(String, String, String)	Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
UploadFileTaskAsync(String, String)	Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
UploadFileTaskAsync(Uri, String)	Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

UploadFileTaskAsync(Uri, String, String)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string? method, string fileName);

member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

Parametry

address

Uri

Identyfikator URI zasobu do odbierania pliku. W przypadku zasobów HTTP ten identyfikator URI musi zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

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.

fileName

String

Plik lokalny do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte zawierającą treść odpowiedzi otrzymanej z zasobu podczas przekazywania pliku.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

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

-lub-

fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

Nagłówek Content-type zaczyna się od multipart.

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 operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu pliku do zasobu. Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

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 (""), 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.

Domyślnie 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.

UploadFileTaskAsync(String, String, String)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string? method, string fileName);

member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

Parametry

address

String

Identyfikator URI zasobu do odbierania pliku. W przypadku zasobów HTTP ten identyfikator URI musi zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

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.

fileName

String

Plik lokalny do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte zawierającą treść odpowiedzi otrzymanej z zasobu podczas przekazywania pliku.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

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

-lub-

fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

Nagłówek Content-type zaczyna się od multipart.

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 operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu pliku do zasobu. Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

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 (""), 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.

Domyślnie 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.

UploadFileTaskAsync(String, String)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string fileName);

member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

Parametry

address

String

Identyfikator URI zasobu do odbierania pliku. W przypadku zasobów HTTP ten identyfikator URI musi zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

fileName

String

Plik lokalny do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte zawierającą treść odpowiedzi otrzymanej z zasobu podczas przekazywania pliku.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

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

-lub-

fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

Nagłówek Content-type zaczyna się od multipart.

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 operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu pliku do zasobu. Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

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 (""), 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.

UploadFileTaskAsync(Uri, String)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);

member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>

Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

Parametry

address

Uri

Identyfikator URI zasobu do odbierania pliku. W przypadku zasobów HTTP ten identyfikator URI musi zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

fileName

String

Plik lokalny do wysłania do zasobu.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte zawierającą treść odpowiedzi otrzymanej z zasobu podczas przekazywania pliku.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

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

-lub-

fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.

-lub-

Wystąpił błąd podczas otwierania strumienia.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

Nagłówek Content-type zaczyna się od multipart.

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 operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po przekazaniu pliku do zasobu. Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

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 (""), 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.