WebClient.OpenWrite Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- WebClient.cs
- 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
Une Stream utilisée pour écrire des données dans la ressource.
Exceptions
Le paramètre address
est null
.
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
, ServicePoint
et 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.
S’applique à
OpenWrite(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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
Une Stream utilisée pour écrire des données dans la ressource.
Exceptions
Le paramètre address
est null
.
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
, ServicePoint
et 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.
S’applique à
OpenWrite(String, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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);
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
Une Stream utilisée pour écrire des données dans la ressource.
Exceptions
Le paramètre address
est null
.
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
, ServicePoint
et 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.
S’applique à
OpenWrite(Uri, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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);
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
Une Stream utilisée pour écrire des données dans la ressource.
Exceptions
Le paramètre address
est null
.
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
, ServicePoint
et 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.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour