WebClient.OpenWriteTaskAsync WebClient.OpenWriteTaskAsync WebClient.OpenWriteTaskAsync WebClient.OpenWriteTaskAsync Method

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) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) 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) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) 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) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) 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) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) 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) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) 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 String String 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.

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 ne bloque pas.This operation will not block. Retourné Task<TResult> objet se terminer après le flux de données accessible en écriture à la ressource de données a été ouverte.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 l’ouverture du flux.This method does not block the calling thread while the stream is opening.

Cette méthode récupère un Stream instance utilisée pour écrire des données dans la ressource spécifiée par le address paramètre.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 automatiquement allouées à 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 le 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 CancelAsync (méthode).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si le BaseAddress propriété n’est pas une chaîne vide (" ») et address ne contient pas un 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 le QueryString propriété 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 transférer une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode POST 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 le traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) 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 Uri 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.

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 ne bloque pas.This operation will not block. Retourné Task<TResult> objet se terminer après le flux de données accessible en écriture à la ressource de données a été ouverte.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 l’ouverture du flux.This method does not block the calling thread while the stream is opening.

Cette méthode récupère un Stream instance utilisée pour écrire des données dans la ressource spécifiée par le address paramètre.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 automatiquement allouées à 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 le 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 CancelAsync (méthode).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si le BaseAddress propriété n’est pas une chaîne vide (" ») et address ne contient pas un 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 le QueryString propriété 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 transférer une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode POST 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 le traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) 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 String String String

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

method
String String String 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.

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 ne bloque pas.This operation will not block. Retourné Task<TResult> objet se terminer après le flux de données accessible en écriture à la ressource de données a été ouverte.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 l’ouverture du flux.This method does not block the calling thread while the stream is opening.

Cette méthode récupère un Stream instance utilisée pour écrire des données dans la ressource spécifiée par le address paramètre.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 automatiquement allouées à 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 le 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 method paramètre spécifie une méthode qui n’est pas compris 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, un WebException est levée avec le Status la valeur de propriété 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 CancelAsync (méthode).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si le BaseAddress propriété n’est pas une chaîne vide (" ») et address ne contient pas un 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 le QueryString propriété 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 transférer une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode POST 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 le traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) 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 Uri Uri

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

method
String String String 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.

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 ne bloque pas.This operation will not block. Retourné Task<TResult> objet se terminer après le flux de données accessible en écriture à la ressource de données a été ouverte.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 l’ouverture du flux.This method does not block the calling thread while the stream is opening.

Cette méthode récupère un Stream instance utilisée pour écrire des données dans la ressource spécifiée par le address paramètre.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 automatiquement allouées à 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 le 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 method paramètre spécifie une méthode qui n’est pas compris 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, un WebException est levée avec le Status la valeur de propriété 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 CancelAsync (méthode).Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Si le BaseAddress propriété n’est pas une chaîne vide (" ») et address ne contient pas un 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 le QueryString propriété 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 transférer une ressource FTP.This method uses the STOR command to upload an FTP resource. Pour une ressource HTTP, la méthode POST 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 le traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

S’applique à