Udostępnij za pośrednictwem

WebClient.UploadFileAsync Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.WebClient.dll
Zestaw:
System.dll
Zestaw:
netstandard.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
Źródło:
WebClient.cs
Ź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 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 do wysłania do zasobu.

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.

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 program obsługi zdarzeń do zdarzenia UploadFileCompleted.

Ta metoda nie blokuje wątku wywołującego podczas wysyłania pliku. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadFile.

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.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez UploadFile(Uri, String).

Dotyczy

UploadFileAsync(Uri, String, String)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Ź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);
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 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 do wysłania do zasobu.

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.

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 program obsługi zdarzeń do zdarzenia UploadFileCompleted.

Ta metoda nie blokuje wątku wywołującego podczas wysyłania pliku. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadFile.

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.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez UploadFile(Uri, String, String).

Dotyczy

UploadFileAsync(Uri, String, String, Object)

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

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 program obsługi zdarzeń do zdarzenia UploadFileCompleted.

Ta metoda nie blokuje wątku wywołującego podczas wysyłania pliku. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadFile.

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.

Dotyczy