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

Transfère la chaîne spécifiée vers la ressource spécifiée.

Surcharges

UploadString(String, String)

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode POST.
UploadString(Uri, String)

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode POST.
UploadString(String, String, String)

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode indiquée.
UploadString(Uri, String, String)

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode indiquée.

UploadString(String, String)

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

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant 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 devant recevoir la chaîne. Pour les ressources HTTP, cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de la méthode POST, tel qu'un script ou une page ASP.

data
String

Chaîne à transférer.

Retours

String

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

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas 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

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la Encoding propriété . Cette méthode bloque pendant 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 UploadStringAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide («  »), et address ne contient pas d’URI absolu, address doit être un URI relatif qui est 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 à

UploadString(Uri, String)

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

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant 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 devant recevoir la chaîne. Pour les ressources HTTP, cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de la méthode POST, tel qu'un script ou une page ASP.

data
String

Chaîne à transférer.

Retours

String

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

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas de réponse du serveur hébergeant la ressource.

Remarques

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la Encoding propriété . Cette méthode bloque pendant 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 UploadStringAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide («  »), et address ne contient pas d’URI absolu, address doit être un URI relatif qui est 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 à

UploadString(String, String, String)

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

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode indiqué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 devant recevoir la chaîne. Cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de 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 à transférer.

Retours

String

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

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas 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

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la Encoding propriété . Cette méthode bloque pendant 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 UploadStringAsync 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 à

UploadString(Uri, String, String)

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

Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode indiqué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 devant recevoir la chaîne. Cet URI doit identifier une ressource capable d'accepter une demande envoyée à l'aide de 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 à transférer.

Retours

String

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

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

- ou -

Le paramètre data a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.

- ou -

Il n'y avait pas de réponse du serveur hébergeant la ressource.

- ou -

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

Remarques

Avant de charger la chaîne, cette méthode la convertit en tableau Byte à l’aide de l’encodage spécifié dans la Encoding propriété . Cette méthode bloque pendant 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 UploadStringAsync 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 à