Partager via

WebClient.UploadData Méthode

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Charge une mémoire tampon de données dans une ressource avec l’URI spécifié.

Surcharges

UploadData(String, Byte[])

Charge une mémoire tampon de données dans une ressource identifiée par un URI.
UploadData(Uri, Byte[])

Charge une mémoire tampon de données dans une ressource identifiée par un URI.
UploadData(String, String, Byte[])

Charge une mémoire tampon de données dans la ressource spécifiée à l’aide de la méthode spécifiée.
UploadData(Uri, String, Byte[])

Charge une mémoire tampon de données dans la ressource spécifiée à l’aide de la méthode spécifiée.

UploadData(String, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge une mémoire tampon de données dans une ressource identifiée par un URI.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData (string address, byte[] data);
member this.UploadData : string * byte[] -> byte[]
Public Function UploadData (address As String, data As Byte()) As Byte()

Paramètres

address
String

URI de la ressource pour recevoir les données.

data
Byte[]

Mémoire tampon de données à envoyer à la ressource.

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

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

-ou-

data est null.

-ou-

Une erreur s’est produite lors de l’envoi des données.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

Exemples

L’exemple de code suivant convertit une chaîne entrée de la console en tableau Byte et publie le tableau sur le serveur spécifié à l’aide de UploadData. Toute réponse du serveur s’affiche sur la console.

Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII Encoding to obtain the String* as a Byte array.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

//UploadData implicitly sets HTTP POST as the request method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, postArray );

// Decode and display the response.
Console::WriteLine( "\nResponse received was: {0}", Encoding::ASCII->GetString( responseArray ) );

    Console.Write("\nPlease enter the URI to post data to : ");
    string uriString = Console.ReadLine();
    // Create a new WebClient instance.
    WebClient myWebClient = new WebClient();
    Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
    string postData = Console.ReadLine();
    // Apply ASCII Encoding to obtain the string as a byte array.
    byte[] postArray = Encoding.ASCII.GetBytes(postData);
    Console.WriteLine("Uploading to {0} ...",  uriString);							
 myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

    //UploadData implicitly sets HTTP POST as the request method.
    byte[] responseArray = myWebClient.UploadData(uriString,postArray);

    // Decode and display the response.
    Console.WriteLine("\nResponse received was :{0}", Encoding.ASCII.GetString(responseArray));

Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
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 the string as a byte array.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' UploadData implicitly sets HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

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 UploadData envoie une mémoire tampon de données à une ressource.

Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée. Si la demande sous-jacente 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.

La méthode UploadData envoie le contenu de data au serveur sans l’encoder. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadDataAsync.

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 à

UploadData(Uri, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge une mémoire tampon de données dans une ressource identifiée par un URI.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData (Uri address, byte[] data);
member this.UploadData : Uri * byte[] -> byte[]
Public Function UploadData (address As Uri, data As Byte()) As Byte()

Paramètres

address
Uri

URI de la ressource pour recevoir les données.

data
Byte[]

Mémoire tampon de données à envoyer à la ressource.

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

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

-ou-

data est null.

-ou-

Une erreur s’est produite lors de l’envoi des données.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

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 UploadData envoie une mémoire tampon de données à une ressource.

Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée. Si la demande sous-jacente 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.

La méthode UploadData envoie le contenu de data au serveur sans l’encoder. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadDataAsync.

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 à

UploadData(String, String, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge une mémoire tampon de données dans la ressource spécifiée à l’aide de la méthode spécifiée.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData (string address, string? method, byte[] data);
public byte[] UploadData (string address, string method, byte[] data);
member this.UploadData : string * string * byte[] -> byte[]
Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

Paramètres

address
String

URI de la ressource pour recevoir les données.

method
String

Méthode HTTP 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.

data
Byte[]

Mémoire tampon de données à envoyer à la ressource.

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

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

-ou-

data est null.

-ou-

Une erreur s’est produite lors du chargement des données.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

Exemples

L’exemple de code suivant convertit une chaîne entrée à partir de la console en tableau d’octets et publie le tableau sur le serveur spécifié à l’aide de UploadData. Toute réponse du serveur s’affiche sur la console.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);

// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
   Encoding::ASCII->GetString( responseArray ) );

   string uriString;
       Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
       uriString = Console.ReadLine();

       // Create a new WebClient instance.
       WebClient myWebClient = new WebClient();
       Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
       string postData = Console.ReadLine();
       myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

 // Display the headers in the request
       Console.Write("Resulting Request Headers: ");
       Console.WriteLine(myWebClient.Headers.ToString());
       
       // Apply ASCII Encoding to obtain the string as a byte array.

       byte[] byteArray = Encoding.ASCII.GetBytes(postData);
       Console.WriteLine("Uploading to {0} ...",  uriString);						
       // Upload the input string using the HTTP 1.0 POST method.
       byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
       
       // Decode and display the response.
       Console.WriteLine("\nResponse received was {0}",
       Encoding.ASCII.GetString(responseArray));
                 

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())

' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

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 UploadData envoie une mémoire tampon de données à une ressource à l’aide de la méthode HTTP spécifiée dans le paramètre method et retourne toute réponse du serveur. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadDataAsync.

La méthode UploadData envoie le contenu de data au serveur sans l’encoder.

Si le paramètre method spécifie un verbe qui n’est pas compris 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 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 à

UploadData(Uri, String, Byte[])

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge une mémoire tampon de données dans la ressource spécifiée à l’aide de la méthode spécifiée.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData (Uri address, string? method, byte[] data);
public byte[] UploadData (Uri address, string method, byte[] data);
member this.UploadData : Uri * string * byte[] -> byte[]
Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

Paramètres

address
Uri

URI de la ressource pour recevoir les données.

method
String

Méthode HTTP 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.

data
Byte[]

Mémoire tampon de données à envoyer à la ressource.

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

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

-ou-

data est null.

-ou-

Une erreur s’est produite lors du chargement des données.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

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 UploadData envoie une mémoire tampon de données à une ressource à l’aide de la méthode HTTP spécifiée dans le paramètre method et retourne toute réponse du serveur. Cette méthode bloque lors du chargement des données. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadDataAsync.

La méthode UploadData envoie le contenu de data au serveur sans l’encoder.

Si le paramètre method spécifie un verbe qui n’est pas compris 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 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 à