WebClient.UploadFileTaskAsync 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 um recurso como uma operação assíncrona usando um objeto de tarefa. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| UploadFileTaskAsync(Uri, String, String) |
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa. |
| UploadFileTaskAsync(String, String, String) |
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa. |
| UploadFileTaskAsync(String, String) |
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa. |
| UploadFileTaskAsync(Uri, String) |
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa. |
UploadFileTaskAsync(Uri, String, String)
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(Uri address, string method, string fileName);public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(Uri address, string method, string fileName);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>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())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 local para enviar ao recurso.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o corpo da resposta recebida do recurso quando o ficheiro foi carregado.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de o ficheiro ter sido carregado para o recurso. O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads.
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.
Por defeito, 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.
Aplica-se a
UploadFileTaskAsync(String, String, String)
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(string address, string method, string fileName);public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(string address, string method, string fileName);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>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())Parâmetros
- address
- String
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 local para enviar ao recurso.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o corpo da resposta recebida do recurso quando o ficheiro foi carregado.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de o ficheiro ter sido carregado para o recurso. O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads.
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.
Por defeito, 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.
Aplica-se a
UploadFileTaskAsync(String, String)
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(string address, string fileName);public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(string address, string fileName);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())Parâmetros
- address
- String
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 local para enviar ao recurso.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o corpo da resposta recebida do recurso quando o ficheiro foi carregado.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de o ficheiro ter sido carregado para o recurso. O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads.
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.
Aplica-se a
UploadFileTaskAsync(Uri, String)
Carrega o ficheiro local especificado para um recurso como uma operação assíncrona usando um objeto de tarefa.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(Uri address, string fileName);public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync(Uri address, string fileName);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())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 local para enviar ao recurso.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o corpo da resposta recebida do recurso quando o ficheiro foi carregado.
- Atributos
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de o ficheiro ter sido carregado para o recurso. O ficheiro é enviado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads.
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.