WebClient.UploadFileAsync Metoda

Definicja

Przekazuje określony plik lokalny do określonego zasobu.Uploads the specified local file to the specified resource. Te metody nie blokują wątku wywołującego.These methods do not block the calling thread.

Przeciążenia

UploadFileAsync(Uri, String)

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST.Uploads the specified local file to the specified resource, using the POST method. Ta metoda nie blokuje wątku wywołującego.This method does not block the calling thread.

UploadFileAsync(Uri, String, String)

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST.Uploads the specified local file to the specified resource, using the POST method. Ta metoda nie blokuje wątku wywołującego.This method does not block the calling thread.

UploadFileAsync(Uri, String, String, Object)

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST.Uploads the specified local file to the specified resource, using the POST method. Ta metoda nie blokuje wątku wywołującego.This method does not block the calling thread.

UploadFileAsync(Uri, String)

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST.Uploads the specified local file to the specified resource, using the POST method. Ta metoda nie blokuje wątku wywołującego.This method does not block the calling thread.

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 którego ma zostać odebrany plik.The URI of the resource to receive the file. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysłane za pomocą metody POST, takie jak strona skryptu lub ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

fileName
String

Plik do wysłania do zasobu.The file to send to the resource.

Wyjątki

Parametr address ma wartość null.The address parameter is null.

— lub —-or- Parametr fileName ma wartość null.The fileName parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

— lub —-or- Brak odpowiedzi z serwera, na którym znajduje się zasób.There was no response from the server hosting the resource.

— lub —-or- Nagłówek Content-type rozpoczyna się od multipart.The Content-type header begins with multipart.

Uwagi

Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. Aby otrzymać powiadomienie po zakończeniu przekazywania pliku, Dodaj program obsługi zdarzeń do zdarzenia UploadFileCompleted.To receive notification when the file upload completes, add an event handler to the UploadFileCompleted event.

Ta metoda nie blokuje wątku wywołującego, gdy plik jest wysyłany.This method does not block the calling thread while the file is being sent. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadFile metod.To send a file and block while waiting for the server's response, use one of the UploadFile methods.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadFileAsync(Uri, String, String)

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST.Uploads the specified local file to the specified resource, using the POST method. Ta metoda nie blokuje wątku wywołującego.This method does not block the calling thread.

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 którego ma zostać odebrany plik.The URI of the resource to receive the file. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysłane za pomocą metody POST, takie jak strona skryptu lub ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

Metoda używana do wysyłania danych do zasobu.The method used to send the data to the resource. Jeśli null, wartość domyślna to POST dla protokołów HTTP i STOR dla usługi FTP.If null, the default is POST for http and STOR for ftp.

fileName
String

Plik do wysłania do zasobu.The file to send to the resource.

Wyjątki

Parametr address ma wartość null.The address parameter is null.

— lub —-or- Parametr fileName ma wartość null.The fileName parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

— lub —-or- Brak odpowiedzi z serwera, na którym znajduje się zasób.There was no response from the server hosting the resource.

— lub —-or- Nagłówek Content-type rozpoczyna się od multipart.The Content-type header begins with multipart.

Uwagi

Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. Aby otrzymać powiadomienie po zakończeniu przekazywania pliku, Dodaj program obsługi zdarzeń do zdarzenia UploadFileCompleted.To receive notification when the file upload completes, add an event handler to the UploadFileCompleted event.

Ta metoda nie blokuje wątku wywołującego, gdy plik jest wysyłany.This method does not block the calling thread while the file is being sent. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadFile metod.To send a file and block while waiting for the server's response, use one of the UploadFile methods.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

UploadFileAsync(Uri, String, String, Object)

Przekazuje określony plik lokalny do określonego zasobu przy użyciu metody POST.Uploads the specified local file to the specified resource, using the POST method. Ta metoda nie blokuje wątku wywołującego.This method does not block the calling thread.

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 którego ma zostać odebrany plik.The URI of the resource to receive the file. W przypadku zasobów HTTP ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysłane za pomocą metody POST, takie jak strona skryptu lub ASP.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

Metoda używana do wysyłania danych do zasobu.The method used to send the data to the resource. Jeśli null, wartość domyślna to POST dla protokołów HTTP i STOR dla usługi FTP.If null, the default is POST for http and STOR for ftp.

fileName
String

Plik do wysłania do zasobu.The file to send to the resource.

userToken
Object

Obiekt zdefiniowany przez użytkownika, który jest przesyłany do metody wywoływanej po zakończeniu operacji asynchronicznej.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Wyjątki

Parametr address ma wartość null.The address parameter is null.

— lub —-or- Parametr fileName ma wartość null.The fileName parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- fileName jest null, jest Empty, zawiera nieprawidłowy znak lub określona ścieżka do pliku nie istnieje.fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

— lub —-or- Brak odpowiedzi z serwera, na którym znajduje się zasób.There was no response from the server hosting the resource.

— lub —-or- Nagłówek Content-type rozpoczyna się od multipart.The Content-type header begins with multipart.

Uwagi

Plik jest wysyłany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. Aby otrzymać powiadomienie po zakończeniu przekazywania pliku, Dodaj program obsługi zdarzeń do zdarzenia UploadFileCompleted.To receive notification when the file upload completes, add an event handler to the UploadFileCompleted event.

Ta metoda nie blokuje wątku wywołującego, gdy plik jest wysyłany.This method does not block the calling thread while the file is being sent. Aby wysłać plik i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadFile metod.To send a file and block while waiting for the server's response, use one of the UploadFile methods.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

Dotyczy