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 lisible permettant d'écrire les données téléchargées sur une ressource ayant l'URI spécifié.
Surcharges
OpenWrite(String) |
Ouvre un flux pour l'écriture de données sur la ressource spécifiée. |
OpenWrite(Uri) |
Ouvre un flux pour l'écriture de données sur 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 en utilisant la méthode spécifiée. |
OpenWrite(String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Ouvre un flux pour l'écriture de données sur 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 devant recevoir les données.
Retours
Stream utilisé pour écrire les données sur la ressource.
Exceptions
Le paramètre address
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non 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. Le Stream retourné par OpenWrite est fermé après l’envoi des 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;
// 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
La OpenWrite méthode retourne un flux accessible en écriture qui est 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 OpenWriteAsync des méthodes .
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
il doit s’agir d’un URI relatif combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété 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.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage 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 l'écriture de données sur 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 devant recevoir les données.
Retours
Stream utilisé pour écrire les données sur la ressource.
Exceptions
Le paramètre address
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non valide.
- ou -
Une erreur s'est produite lors de l'ouverture du flux.
Remarques
La OpenWrite méthode retourne un flux accessible en écriture qui est 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 OpenWriteAsync des méthodes .
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
il doit s’agir d’un URI relatif combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété 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.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage 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 devant recevoir les données.
- method
- String
Méthode utilisée pour envoyer des données à la ressource. Si la valeur est null, la valeur par défaut est POST pour http et STOR pour ftp.
Retours
Stream utilisé pour écrire les données sur la ressource.
Exceptions
Le paramètre address
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non 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. Le Stream retourné par OpenWrite doit être fermé 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
La OpenWrite méthode retourne un flux accessible en écriture qui est 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 method
paramètre . 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 OpenWriteAsync des méthodes .
Si le method
paramètre 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, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne spécifie pas d’adresse absolue, address
doit être un URI relatif combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas une chaîne vide, elle est ajoutée à address
.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage 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 en utilisant 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 devant recevoir les données.
- method
- String
Méthode utilisée pour envoyer des données à la ressource. Si la valeur est null, la valeur par défaut est POST pour http et STOR pour ftp.
Retours
Stream utilisé pour écrire les données sur la ressource.
Exceptions
Le paramètre address
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non valide.
- ou -
Une erreur s'est produite lors de l'ouverture du flux.
Remarques
La OpenWrite méthode retourne un flux accessible en écriture qui est 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 OpenWriteAsync des méthodes .
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
il doit s’agir d’un URI relatif combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas une chaîne vide, elle est ajoutée à address
.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage 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 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour