WebClient.OpenWrite Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Ouvre un flux pour écrire des données dans une ressource avec l’URI spécifié.

Surcharges

OpenWrite(String)	Ouvre un flux pour écrire des données dans la ressource spécifiée.
OpenWrite(Uri)	Ouvre un flux pour écrire des données dans la ressource spécifiée.
OpenWrite(String, String)	Ouvre un flux pour écrire des données dans la ressource spécifiée, à l’aide de la méthode spécifiée.
OpenWrite(Uri, String)	Ouvre un flux pour écrire des données dans la ressource spécifiée, à l’aide de la méthode spécifiée.

OpenWrite(String)

Source:

WebClient.cs

Ouvre un flux pour écrire des données dans la ressource spécifiée.

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address);

public System.IO.Stream OpenWrite (string address);

member this.OpenWrite : string -> System.IO.Stream

Public Function OpenWrite (address As String) As Stream

Paramètres

address

String

URI de la ressource pour recevoir les données.

Retours

Stream

Une Stream utilisée pour écrire des données dans la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

L’URI formé en combinant BaseAddresset address n’est pas valide.

-ou-

Une erreur s’est produite lors de l’ouverture du flux.

Exemples

L’exemple de code suivant lit les données de la ligne de commande et utilise OpenWrite pour obtenir un flux pour écrire les données. La Stream retournée par OpenWrite est fermée une fois les données envoyées.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply Ascii Encoding to obtain an array of bytes.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// postStream implicitly sets HTTP POST as the request method.
Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString );

postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();

Console::WriteLine( "\nSuccessfully posted the data." );

string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply Ascii Encoding to obtain an array of bytes. 
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

// postStream implicitly sets HTTP POST as the request method.
Console.WriteLine("Uploading to {0} ...",  uriString);							Stream postStream = myWebClient.OpenWrite(uriString);

postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();

Console.WriteLine("\nSuccessfully posted the data.");

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)

Dim postData As String = Console.ReadLine()

' Apply ASCII Encoding to obtain an array of bytes .
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)

' OpenWrite implicitly sets HTTP POST as the request method.
Dim postStream As Stream = myWebClient.OpenWrite(uriString)
postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La méthode OpenWrite retourne un flux accessible en écriture utilisé pour envoyer des données à une ressource. Cette méthode bloque lors de l’ouverture du flux. Pour continuer à s’exécuter en attendant le flux, utilisez l’une des méthodes OpenWriteAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

OpenWrite(Uri)

Source:

WebClient.cs

Ouvre un flux pour écrire des données dans la ressource spécifiée.

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address);

public System.IO.Stream OpenWrite (Uri address);

member this.OpenWrite : Uri -> System.IO.Stream

Public Function OpenWrite (address As Uri) As Stream

Paramètres

address

Uri

URI de la ressource pour recevoir les données.

Retours

Stream

Une Stream utilisée pour écrire des données dans la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

L’URI formé en combinant BaseAddresset address n’est pas valide.

-ou-

Une erreur s’est produite lors de l’ouverture du flux.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La méthode OpenWrite retourne un flux accessible en écriture utilisé pour envoyer des données à une ressource. Cette méthode bloque lors de l’ouverture du flux. Pour continuer à s’exécuter en attendant le flux, utilisez l’une des méthodes OpenWriteAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

OpenWrite(String, String)

Source:

WebClient.cs

Ouvre un flux pour écrire des données dans la ressource spécifiée, à l’aide de la méthode spécifiée.

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);

public System.IO.Stream OpenWrite (string address, string? method);

member this.OpenWrite : string * string -> System.IO.Stream

Public Function OpenWrite (address As String, method As String) As Stream

Paramètres

address

String

URI de la ressource pour recevoir les données.

method

String

Méthode utilisée pour envoyer les données à la ressource. Si la valeur est Null, la valeur par défaut est POST pour http et STOR pour ftp.

Retours

Stream

Une Stream utilisée pour écrire des données dans la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

L’URI formé en combinant BaseAddresset address n’est pas valide.

-ou-

Une erreur s’est produite lors de l’ouverture du flux.

Exemples

L’exemple de code suivant lit les données de la ligne de commande et utilise OpenWrite pour obtenir un flux utilisé pour écrire les données. Les Stream retournées par OpenWrite doivent être fermées pour envoyer les données.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString, "POST" );
postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();
Console::WriteLine( "\nSuccessfully posted the data." );

string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("Uploading to {0} ...",  uriString);						
Stream postStream = myWebClient.OpenWrite(uriString,"POST");
postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();
Console.WriteLine("\nSuccessfully posted the data.");

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII encoding to obtain an array of bytes.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)
Dim postStream As Stream = myWebClient.OpenWrite(uriString, "POST")

postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La méthode OpenWrite retourne un flux accessible en écriture utilisé pour envoyer des données à une ressource. La requête sous-jacente est effectuée avec la méthode spécifiée dans le paramètre method. Les données sont envoyées au serveur lorsque vous fermez le flux. Cette méthode bloque lors de l’ouverture du flux. Pour continuer à s’exécuter en attendant le flux, utilisez l’une des méthodes OpenWriteAsync.

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. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne spécifie pas d’adresse absolue, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

OpenWrite(Uri, String)

Source:

WebClient.cs

Ouvre un flux pour écrire des données dans la ressource spécifiée, à l’aide de la méthode spécifiée.

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);

public System.IO.Stream OpenWrite (Uri address, string? method);

member this.OpenWrite : Uri * string -> System.IO.Stream

Public Function OpenWrite (address As Uri, method As String) As Stream

Paramètres

address

Uri

URI de la ressource pour recevoir les données.

method

String

Méthode utilisée pour envoyer les données à la ressource. Si la valeur est Null, la valeur par défaut est POST pour http et STOR pour ftp.

Retours

Stream

Une Stream utilisée pour écrire des données dans la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

L’URI formé en combinant BaseAddresset address n’est pas valide.

-ou-

Une erreur s’est produite lors de l’ouverture du flux.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La méthode OpenWrite retourne un flux accessible en écriture utilisé pour envoyer des données à une ressource. Cette méthode bloque lors de l’ouverture du flux. Pour continuer à s’exécuter en attendant le flux, utilisez l’une des méthodes OpenWriteAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.