WebClient.UploadFileAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Carrega o ficheiro local especificado para o recurso especificado. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| UploadFileAsync(Uri, String) |
Carrega o ficheiro local especificado para o recurso especificado, usando o método POST. Este método não bloqueia o thread que chama. |
| UploadFileAsync(Uri, String, String) |
Carrega o ficheiro local especificado para o recurso especificado, usando o método POST. Este método não bloqueia o thread que chama. |
| UploadFileAsync(Uri, String, String, Object) |
Carrega o ficheiro local especificado para o recurso especificado, usando o método POST. Este método não bloqueia o thread que chama. |
UploadFileAsync(Uri, String)
Carrega o ficheiro local especificado para o recurso especificado, usando o método POST. Este método não bloqueia o thread que chama.
public:
void UploadFileAsync(Uri ^ address, System::String ^ fileName);public void UploadFileAsync(Uri address, string fileName);member this.UploadFileAsync : Uri * string -> unitPublic Sub UploadFileAsync (address As Uri, fileName As String)Parâmetros
- address
- Uri
O URI do recurso a receber o ficheiro. Para recursos HTTP, este URI deve identificar um recurso que possa aceitar um pedido enviado com o método POST, como um script ou página ASP.
- fileName
- String
O ficheiro para enviar ao recurso.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
fileName é null, é Empty, contém carácter inválido, ou o caminho especificado para o ficheiro não existe.
-ou-
Ocorreu um erro ao abrir a transmissão.
-ou-
Não houve resposta do servidor que hospedava o recurso.
-ou-
O Content-type cabeçalho começa por multipart.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o carregamento do ficheiro terminar, adicione um gestor de eventos ao UploadFileCompleted evento.
Este método não bloqueia a thread que chama enquanto o ficheiro está a ser enviado. Para enviar um ficheiro e bloquear enquanto espera a resposta do servidor, use um dos UploadFile métodos.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Se a BaseAddress propriedade não for uma cadeia vazia (""), address deve ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.
Este método utiliza o comando STOR para carregar um recurso FTP. Para um recurso HTTP, é utilizado o método POST.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por UploadFile(Uri, String).
Aplica-se a
UploadFileAsync(Uri, String, String)
Carrega o ficheiro local especificado para o recurso especificado, usando o método POST. Este método não bloqueia o thread que chama.
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 -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String)Parâmetros
- address
- Uri
O URI do recurso a receber o ficheiro. Para recursos HTTP, este URI deve identificar um recurso que possa aceitar um pedido enviado com o método POST, como um script ou página ASP.
- method
- String
O método utilizado para enviar os dados para o recurso. Se null, o padrão é POST para http e STOR para ftp.
- fileName
- String
O ficheiro para enviar ao recurso.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
fileName é null, é Empty, contém carácter inválido, ou o caminho especificado para o ficheiro não existe.
-ou-
Ocorreu um erro ao abrir a transmissão.
-ou-
Não houve resposta do servidor que hospedava o recurso.
-ou-
O Content-type cabeçalho começa por multipart.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o carregamento do ficheiro terminar, adicione um gestor de eventos ao UploadFileCompleted evento.
Este método não bloqueia a thread que chama enquanto o ficheiro está a ser enviado. Para enviar um ficheiro e bloquear enquanto espera a resposta do servidor, use um dos UploadFile métodos.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Se a BaseAddress propriedade não for uma cadeia vazia (""), address deve ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.
Este método utiliza o comando STOR para carregar um recurso FTP. Para um recurso HTTP, é utilizado o método POST.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por UploadFile(Uri, String, String).
Aplica-se a
UploadFileAsync(Uri, String, String, Object)
Carrega o ficheiro local especificado para o recurso especificado, usando o método POST. Este método não bloqueia o thread que chama.
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 -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)Parâmetros
- address
- Uri
O URI do recurso a receber o ficheiro. Para recursos HTTP, este URI deve identificar um recurso que possa aceitar um pedido enviado com o método POST, como um script ou página ASP.
- method
- String
O método utilizado para enviar os dados para o recurso. Se null, o padrão é POST para http e STOR para ftp.
- fileName
- String
O ficheiro para enviar ao recurso.
- userToken
- Object
Um objeto definido pelo utilizador que é passado para o método invocado quando a operação assíncrona termina.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
fileName é null, é Empty, contém carácter inválido, ou o caminho especificado para o ficheiro não existe.
-ou-
Ocorreu um erro ao abrir a transmissão.
-ou-
Não houve resposta do servidor que hospedava o recurso.
-ou-
O Content-type cabeçalho começa por multipart.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o carregamento do ficheiro terminar, adicione um gestor de eventos ao UploadFileCompleted evento.
Este método não bloqueia a thread que chama enquanto o ficheiro está a ser enviado. Para enviar um ficheiro e bloquear enquanto espera a resposta do servidor, use um dos UploadFile métodos.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Se a BaseAddress propriedade não for uma cadeia vazia (""), address deve ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.
Este método utiliza o comando STOR para carregar um recurso FTP. Para um recurso HTTP, é utilizado o método POST.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.