WebClient.OpenWriteTaskAsync 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.
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| OpenWriteTaskAsync(String) |
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa. |
| OpenWriteTaskAsync(Uri) |
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa. |
| OpenWriteTaskAsync(String, String) |
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa. |
| OpenWriteTaskAsync(Uri, String) |
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa. |
OpenWriteTaskAsync(String)
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(string address);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)Parâmetros
- address
- String
O URI do recurso para receber os dados.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto de tarefa devolve um Stream usado para escrever dados no recurso.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
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 um fluxo gravável para o recurso de dados ter sido aberto. Este método não bloqueia o thread que chama enquanto o fluxo está a abrir.
Este método recupera uma Stream instância usada para escrever dados no recurso especificado pelo address parâmetro. O fluxo é obtido usando recursos de threads que são automaticamente alocados a partir do pool de threads.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
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 ("") e address não contiver um URI absoluto, address deve ser um URI relativo 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.
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.
Ver também
Aplica-se a
OpenWriteTaskAsync(Uri)
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(Uri address);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto de tarefa devolve um Stream usado para escrever dados no recurso.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
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 um fluxo gravável para o recurso de dados ter sido aberto. Este método não bloqueia o thread que chama enquanto o fluxo está a abrir.
Este método recupera uma Stream instância usada para escrever dados no recurso especificado pelo address parâmetro. O fluxo é obtido usando recursos de threads que são automaticamente alocados a partir do pool de threads.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
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 ("") e address não contiver um URI absoluto, address deve ser um URI relativo 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.
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
OpenWriteTaskAsync(String, String)
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(string address, string method);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(string address, string method);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)Parâmetros
- address
- String
O URI do recurso para receber os dados.
- method
- String
O método utilizado para enviar os dados para o recurso. Se for nulo, o padrão é POST para http e STOR para ftp.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto de tarefa devolve um Stream usado para escrever dados no recurso.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
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 um fluxo gravável para o recurso de dados ter sido aberto. Este método não bloqueia o thread que chama enquanto o fluxo está a abrir.
Este método recupera uma Stream instância usada para escrever dados no recurso especificado pelo address parâmetro. O fluxo é obtido usando recursos de threads que são automaticamente alocados a partir do pool de threads.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
Se o method parâmetro especificar um método que não é compreendido pelo servidor, as classes de protocolo subjacentes determinam o que ocorre. Normalmente, a WebException é lançado com a Status propriedade definida para indicar o erro.
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 ("") e address não contiver um URI absoluto, address deve ser um URI relativo 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.
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.
Ver também
Aplica-se a
OpenWriteTaskAsync(Uri, String)
Abre um fluxo para escrever dados no recurso especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(Uri address, string method);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(Uri address, string method);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
- method
- String
O método utilizado para enviar os dados para o recurso. Se for nulo, o padrão é POST para http e STOR para ftp.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto de tarefa devolve um Stream usado para escrever dados no recurso.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro ao abrir a transmissão.
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 um fluxo gravável para o recurso de dados ter sido aberto. Este método não bloqueia o thread que chama enquanto o fluxo está a abrir.
Este método recupera uma Stream instância usada para escrever dados no recurso especificado pelo address parâmetro. O fluxo é obtido usando recursos de threads que são automaticamente alocados a partir do pool de threads.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
Se o method parâmetro especificar um método que não é compreendido pelo servidor, as classes de protocolo subjacentes determinam o que ocorre. Normalmente, a WebException é lançado com a Status propriedade definida para indicar o erro.
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 ("") e address não contiver um URI absoluto, address deve ser um URI relativo 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.
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.