WebClient.UploadString 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.
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 contenant la réponse envoyée par le serveur.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre data
a la valeur null
.
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 contenant la réponse envoyée par le serveur.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre data
a la valeur null
.
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 contenant la réponse envoyée par le serveur.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre data
a la valeur null
.
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 contenant la réponse envoyée par le serveur.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre data
a la valeur null
.
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 à
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