WebClient.OpenWriteTaskAsync Méthode

Définition

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object. Ces méthodes ne bloquent pas le thread appelant.These methods do not block the calling thread.

Surcharges

OpenWriteTaskAsync(String)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String, String)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri, String)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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);
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Paramètres

address
String

URI de la ressource devant recevoir les données.The URI of the resource to receive the data.

Retours

Objet de tâche représentant l'opération asynchrone.The task object representing the asynchronous operation. La propriété Result sur l'objet de tâche retourne un Stream utilisé pour écrire des données sur la ressource.The Result property on the task object returns a Stream used to write data to the resource.

Attributs

Exceptions

Le paramètre address a la valeur null.The address parameter is null.

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.The URI formed by combining BaseAddress and address is invalid.

ou-or- Une erreur s'est produite lors de l'ouverture du flux.An error occurred while opening the stream.

Remarques

Cette opération n’est pas bloquée.This operation will not block. L’objet Task<TResult> retourné se termine après qu’un flux accessible en écriture à la ressource de données a été ouvert.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Cette méthode ne bloque pas le thread appelant pendant que le flux est en cours d’ouverture.This method does not block the calling thread while the stream is opening.

Cette méthode récupère une instance Stream utilisée pour écrire des données dans la ressource spécifiée par le paramètre address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Le flux est obtenu à l’aide de ressources de thread allouées automatiquement à partir du pool de threads.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Notes

Vous devez appeler Stream.Close lorsque vous avez terminé avec la Stream pour éviter de manquer de ressources système.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Les opérations asynchrones qui ne sont pas terminées peuvent être annulées à l’aide de la méthode CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si la propriété BaseAddress n’est pas une chaîne vide ("") et que address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.If the QueryString property is not an empty string, it is appended to address.

Cette méthode utilise la commande STOR pour télécharger une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode de publication est utilisée.For an HTTP resource, the POST method is used.

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

OpenWriteTaskAsync(Uri)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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);
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Paramètres

address
Uri

URI de la ressource devant recevoir les données.The URI of the resource to receive the data.

Retours

Objet de tâche représentant l'opération asynchrone.The task object representing the asynchronous operation. La propriété Result sur l'objet de tâche retourne un Stream utilisé pour écrire des données sur la ressource.The Result property on the task object returns a Stream used to write data to the resource.

Attributs

Exceptions

Le paramètre address a la valeur null.The address parameter is null.

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.The URI formed by combining BaseAddress and address is invalid.

- ou --or- Une erreur s'est produite lors de l'ouverture du flux.An error occurred while opening the stream.

Remarques

Cette opération n’est pas bloquée.This operation will not block. L’objet Task<TResult> retourné se termine après qu’un flux accessible en écriture à la ressource de données a été ouvert.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Cette méthode ne bloque pas le thread appelant pendant que le flux est en cours d’ouverture.This method does not block the calling thread while the stream is opening.

Cette méthode récupère une instance Stream utilisée pour écrire des données dans la ressource spécifiée par le paramètre address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Le flux est obtenu à l’aide de ressources de thread allouées automatiquement à partir du pool de threads.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Notes

Vous devez appeler Stream.Close lorsque vous avez terminé avec la Stream pour éviter de manquer de ressources système.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Les opérations asynchrones qui ne sont pas terminées peuvent être annulées à l’aide de la méthode CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si la propriété BaseAddress n’est pas une chaîne vide ("") et que address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.If the QueryString property is not an empty string, it is appended to address.

Cette méthode utilise la commande STOR pour télécharger une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode de publication est utilisée.For an HTTP resource, the POST method is used.

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenWriteTaskAsync(String, String)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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);
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)

Paramètres

address
String

URI de la ressource devant recevoir les données.The URI of the resource to receive the data.

method
String

Méthode utilisée pour envoyer des données à la ressource.The method used to send the data to the resource. Si la valeur est null, la valeur par défaut est POST pour http et STOR pour ftp.If null, the default is POST for http and STOR for ftp.

Retours

Objet de tâche représentant l'opération asynchrone.The task object representing the asynchronous operation. La propriété Result sur l'objet de tâche retourne un Stream utilisé pour écrire des données sur la ressource.The Result property on the task object returns a Stream used to write data to the resource.

Attributs

Exceptions

Le paramètre address a la valeur null.The address parameter is null.

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.The URI formed by combining BaseAddress and address is invalid.

ou-or- Une erreur s'est produite lors de l'ouverture du flux.An error occurred while opening the stream.

Remarques

Cette opération n’est pas bloquée.This operation will not block. L’objet Task<TResult> retourné se termine après qu’un flux accessible en écriture à la ressource de données a été ouvert.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Cette méthode ne bloque pas le thread appelant pendant que le flux est en cours d’ouverture.This method does not block the calling thread while the stream is opening.

Cette méthode récupère une instance Stream utilisée pour écrire des données dans la ressource spécifiée par le paramètre address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Le flux est obtenu à l’aide de ressources de thread allouées automatiquement à partir du pool de threads.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Notes

Vous devez appeler Stream.Close lorsque vous avez terminé avec la Stream pour éviter de manquer de ressources système.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Si le paramètre method spécifie une méthode qui n’est pas comprise par le serveur, les classes de protocole sous-jacentes déterminent ce qui se produit.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.Typically, a WebException is thrown with the Status property set to indicate the error.

Les opérations asynchrones qui ne sont pas terminées peuvent être annulées à l’aide de la méthode CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si la propriété BaseAddress n’est pas une chaîne vide ("") et que address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.If the QueryString property is not an empty string, it is appended to address.

Cette méthode utilise la commande STOR pour télécharger une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode de publication est utilisée.For an HTTP resource, the POST method is used.

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

OpenWriteTaskAsync(Uri, String)

Ouvre un flux pour l'écriture de données sur la ressource spécifiée en tant qu'opération asynchrone à l'aide d'un objet de tâche.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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);
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)

Paramètres

address
Uri

URI de la ressource devant recevoir les données.The URI of the resource to receive the data.

method
String

Méthode utilisée pour envoyer des données à la ressource.The method used to send the data to the resource. Si la valeur est null, la valeur par défaut est POST pour http et STOR pour ftp.If null, the default is POST for http and STOR for ftp.

Retours

Objet de tâche représentant l'opération asynchrone.The task object representing the asynchronous operation. La propriété Result sur l'objet de tâche retourne un Stream utilisé pour écrire des données sur la ressource.The Result property on the task object returns a Stream used to write data to the resource.

Attributs

Exceptions

Le paramètre address a la valeur null.The address parameter is null.

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.The URI formed by combining BaseAddress and address is invalid.

- ou --or- Une erreur s'est produite lors de l'ouverture du flux.An error occurred while opening the stream.

Remarques

Cette opération n’est pas bloquée.This operation will not block. L’objet Task<TResult> retourné se termine après qu’un flux accessible en écriture à la ressource de données a été ouvert.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Cette méthode ne bloque pas le thread appelant pendant que le flux est en cours d’ouverture.This method does not block the calling thread while the stream is opening.

Cette méthode récupère une instance Stream utilisée pour écrire des données dans la ressource spécifiée par le paramètre address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Le flux est obtenu à l’aide de ressources de thread allouées automatiquement à partir du pool de threads.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Notes

Vous devez appeler Stream.Close lorsque vous avez terminé avec la Stream pour éviter de manquer de ressources système.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Si le paramètre method spécifie une méthode qui n’est pas comprise par le serveur, les classes de protocole sous-jacentes déterminent ce qui se produit.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.Typically, a WebException is thrown with the Status property set to indicate the error.

Les opérations asynchrones qui ne sont pas terminées peuvent être annulées à l’aide de la méthode CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si la propriété BaseAddress n’est pas une chaîne vide ("") et que address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.If the QueryString property is not an empty string, it is appended to address.

Cette méthode utilise la commande STOR pour télécharger une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode de publication est utilisée.For an HTTP resource, the POST method is used.

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

S’applique à