WebClient.UploadData 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.
Transmet une mémoire tampon de données à une ressource ayant l'URI spécifié.
Surcharges
| UploadData(String, Byte[]) |
Transmet une mémoire tampon de données à une ressource identifiée par un URI. |
| UploadData(Uri, Byte[]) |
Transmet une mémoire tampon de données à une ressource identifiée par un URI. |
| UploadData(String, String, Byte[]) |
Transfère un tampon de données vers la ressource spécifiée, à l'aide de la méthode spécifiée. |
| UploadData(Uri, String, Byte[]) |
Transfère un tampon de données vers 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
Transmet une mémoire tampon de données à 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 devant recevoir les données.
- data
- Byte[]
Mémoire tampon de données à envoyer à la ressource.
Retours
Tableau de Byte contenant le corps de la réponse de 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 -
data a la valeur null.
- ou -
Une erreur s'est produite lors de l'envoi des données.
- ou -
Il n'y avait pas 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 UploadDatade . Toute réponse du serveur s’affiche dans 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
La UploadData méthode 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 requête 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, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
La UploadData méthode envoie le contenu de data au serveur sans l’encoder. Cette méthode bloque lors du chargement des données. Pour continuer à exécuter en attendant la réponse du serveur, utilisez l’une UploadDataAsync 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 à
UploadData(Uri, Byte[])
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transmet une mémoire tampon de données à 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 devant recevoir les données.
- data
- Byte[]
Mémoire tampon de données à envoyer à la ressource.
Retours
Tableau de Byte contenant le corps de la réponse de 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 -
data a la valeur null.
- ou -
Une erreur s'est produite lors de l'envoi des données.
- ou -
Il n'y avait pas de réponse du serveur hébergeant la ressource.
Remarques
La UploadData méthode 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 requête 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, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
La UploadData méthode envoie le contenu de data au serveur sans l’encoder. Cette méthode bloque lors du chargement des données. Pour continuer à exécuter en attendant la réponse du serveur, utilisez l’une UploadDataAsync 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 à
UploadData(String, String, Byte[])
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transfère un tampon de données vers 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 devant 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
Tableau de Byte contenant le corps de la réponse de 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 -
data a la valeur null.
- ou -
Une erreur s'est produite lors du transfert des données.
- ou -
Il n'y avait pas 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 UploadDatade . Toute réponse du serveur s’affiche dans 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
La UploadData méthode envoie une mémoire tampon de données à une ressource à l’aide de la méthode HTTP spécifiée dans le method paramètre et retourne toute réponse du serveur. Cette méthode bloque lors du chargement des données. Pour continuer à exécuter en attendant la réponse du serveur, utilisez l’une UploadDataAsync des méthodes .
La UploadData méthode envoie le contenu de data au serveur sans l’encoder.
Si le method paramètre 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, 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 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 à
UploadData(Uri, String, Byte[])
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transfère un tampon de données vers 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 devant 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
Tableau de Byte contenant le corps de la réponse de 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 -
data a la valeur null.
- ou -
Une erreur s'est produite lors du transfert des données.
- ou -
Il n'y avait pas de réponse du serveur hébergeant la ressource.
Remarques
La UploadData méthode envoie une mémoire tampon de données à une ressource à l’aide de la méthode HTTP spécifiée dans le method paramètre et retourne toute réponse du serveur. Cette méthode bloque lors du chargement des données. Pour continuer à exécuter en attendant la réponse du serveur, utilisez l’une UploadDataAsync des méthodes .
La UploadData méthode envoie le contenu de data au serveur sans l’encoder.
Si le method paramètre 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, 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 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
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, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour