WebClient.UploadFileAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje określony plik lokalny do określonego zasobu. Te metody nie blokują wątku wywołującego.

Przeciążenia

UploadFileAsync(Uri, String)	Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.
UploadFileAsync(Uri, String, String)	Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.
UploadFileAsync(Uri, String, String, Object)	Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.

UploadFileAsync(Uri, String)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ fileName);

public void UploadFileAsync (Uri address, string fileName);

member this.UploadFileAsync : Uri * string -> unit

Public Sub UploadFileAsync (address As Uri, fileName As String)

Parametry

address

Uri

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

fileName

String

Plik do wysłania do zasobu.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

-lub-

Parametr fileName ma wartość null.

WebException

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

-lub-

fileName to 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

Plik 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 przekazywania pliku, dodaj do zdarzenia program obsługi zdarzeń UploadFileCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania pliku. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadFile 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 (""), address musi być względnym identyfikatorem URI połączonym 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 addresselementu .

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 UploadFile(Uri, String)usługę .

UploadFileAsync(Uri, String, String)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);

public void UploadFileAsync (Uri address, string? method, string fileName);

member this.UploadFileAsync : Uri * string * string -> unit

Public Sub UploadFileAsync (address As Uri, method As String, fileName As String)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania pliku. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysył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 nullwartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.

fileName

String

Plik do wysłania do zasobu.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

-lub-

Parametr fileName ma wartość null.

WebException

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

-lub-

fileName to 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

Plik 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 przekazywania pliku, dodaj do zdarzenia program obsługi zdarzeń UploadFileCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania pliku. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadFile 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 (""), address musi być względnym identyfikatorem URI połączonym 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 addresselementu .

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 UploadFile(Uri, String, String)usługę .

UploadFileAsync(Uri, String, String, Object)

Źródło:

WebClient.cs

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST. Ta metoda nie blokuje wątku wywołującego.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);

public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);

member this.UploadFileAsync : Uri * string * string * obj -> unit

Public Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania pliku. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysył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 nullwartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.

fileName

String

Plik 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 ma wartość null.

-lub-

Parametr fileName ma wartość null.

WebException

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

-lub-

fileName to 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

Plik 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 przekazywania pliku, dodaj do zdarzenia program obsługi zdarzeń UploadFileCompleted .

Ta metoda nie blokuje wywołującego wątku podczas wysyłania pliku. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadFile 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 (""), address musi być względnym identyfikatorem URI połączonym 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 addresselementu .

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.