WebClient.UploadString Méthode

  • Référence

Définition

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

Charge la chaîne spécifiée dans la ressource spécifiée.

Surcharges

UploadString(String, String)

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode POST.
UploadString(Uri, String)

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode POST.
UploadString(String, String, String)

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode spécifiée.
UploadString(Uri, String, String)

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode spécifiée.

UploadString(String, String)

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

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode POST.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);
public string UploadString (string address, string data);
member this.UploadString : string * string -> string
Public Function UploadString (address As String, data As String) As String

Paramètres

address
String

URI de la ressource à recevoir. Pour les ressources Http, cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode POST, telle qu’un script ou une page ASP.

data
String

Chaîne à charger.

Retours

String

Une String contenant la réponse envoyée par le serveur.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

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

-ou-

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

Exemples

L’exemple de code suivant illustre l’appel de cette méthode.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;

   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;

   // Upload the data.
   String^ reply = client->UploadString( address, data );

   // Disply the server's response.
   Console::WriteLine( reply );
}

public static void UploadString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString(address, data);
    // Display the server's response.
    Console.WriteLine(reply);
}

Public Shared Sub UploadString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim client As WebClient = New WebClient()
    '  Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8
    '  Upload the data.
    Dim reply As String = client.UploadString(address, data)
    '  Disply the server's response.
    Console.WriteLine(reply)
End Sub

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.

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la propriété Encoding. Cette méthode bloque la transmission de la chaîne. Pour envoyer une chaîne et continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadStringAsync.

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 à

UploadString(Uri, String)

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

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode POST.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);
public string UploadString (Uri address, string data);
member this.UploadString : Uri * string -> string
Public Function UploadString (address As Uri, data As String) As String

Paramètres

address
Uri

URI de la ressource à recevoir. Pour les ressources Http, cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode POST, telle qu’un script ou une page ASP.

data
String

Chaîne à charger.

Retours

String

Une String contenant la réponse envoyée par le serveur.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

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

-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.

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la propriété Encoding. Cette méthode bloque la transmission de la chaîne. Pour envoyer une chaîne et continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadStringAsync.

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 à

UploadString(String, String, String)

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

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode spécifiée.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);
public string UploadString (string address, string? method, string data);
public string UploadString (string address, string method, string data);
member this.UploadString : string * string * string -> string
Public Function UploadString (address As String, method As String, data As String) As String

Paramètres

address
String

URI de la ressource à recevoir. Cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode method.

method
String

Méthode HTTP utilisée pour envoyer la chaîne à la ressource. Si la valeur est Null, la valeur par défaut est POST pour http et STOR pour ftp.

data
String

Chaîne à charger.

Retours

String

Une String contenant la réponse envoyée par le serveur.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

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

-ou-

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

-ou-

method ne peut pas être utilisé pour envoyer du contenu.

Exemples

L’exemple de code suivant illustre l’appel de cette méthode.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}

public static void PostString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient();
    string reply = client.UploadString(address, method, data);

    Console.WriteLine(reply);
}

Public Shared Sub PostString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim method As String = "POST"
    Dim client As WebClient = New WebClient()
    Dim reply As String = client.UploadString(address, method, data)

    Console.WriteLine(reply)
End Sub

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.

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la propriété Encoding. Cette méthode bloque la transmission de la chaîne. Pour envoyer une chaîne et continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadStringAsync.

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 à

UploadString(Uri, String, String)

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

Charge la chaîne spécifiée dans la ressource spécifiée à l’aide de la méthode spécifiée.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);
public string UploadString (Uri address, string? method, string data);
public string UploadString (Uri address, string method, string data);
member this.UploadString : Uri * string * string -> string
Public Function UploadString (address As Uri, method As String, data As String) As String

Paramètres

address
Uri

URI de la ressource à recevoir. Cet URI doit identifier une ressource qui peut accepter une demande envoyée avec la méthode method.

method
String

Méthode HTTP utilisée pour envoyer la chaîne à la ressource. Si la valeur est Null, la valeur par défaut est POST pour http et STOR pour ftp.

data
String

Chaîne à charger.

Retours

String

Une String contenant la réponse envoyée par le serveur.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre data est null.

WebException

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

-ou-

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

-ou-

method ne peut pas être utilisé pour envoyer du contenu.

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.

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la propriété Encoding. Cette méthode bloque la transmission de la chaîne. Pour envoyer une chaîne et continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadStringAsync.

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 à