WebClient.UploadString Methode

Definitie

Naamruimte:: System.Net

Assembly:: System.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Uploadt de opgegeven tekenreeks naar de opgegeven resource.

Overloads

Name	Description
UploadString(String, String)	Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de POST-methode.
UploadString(Uri, String)	Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de POST-methode.
UploadString(String, String, String)	Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de opgegeven methode.
UploadString(Uri, String, String)	Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de opgegeven methode.

UploadString(String, String)

Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de POST-methode.

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

Parameters

address: String

De URI van de resource om de tekenreeks te ontvangen. Voor Http-resources moet deze URI een resource identificeren die een aanvraag kan accepteren die is verzonden met de POST-methode, zoals een script of ASP-pagina.

data: String

De tekenreeks die moet worden geüpload.

Retouren

String

Een String met het antwoord dat door de server wordt verzonden.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u deze methode aanroept.

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

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Voordat u de tekenreeks uploadt, wordt deze met deze methode geconverteerd naar een Byte matrix met behulp van de codering die is opgegeven in de Encoding eigenschap. Deze methode blokkeert terwijl de tekenreeks wordt verzonden. Als u een tekenreeks wilt verzenden en wilt blijven uitvoeren terwijl u wacht op het antwoord van de server, gebruikt u een van de UploadStringAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadString(Uri, String)

Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de POST-methode.

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

Parameters

address: Uri

data: String

De tekenreeks die moet worden geüpload.

Retouren

String

Een String met het antwoord dat door de server wordt verzonden.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadString(String, String, String)

Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de opgegeven methode.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::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

Parameters

address: String

De URI van de resource om de tekenreeks te ontvangen. Deze URI moet een resource identificeren die een aanvraag kan accepteren die met de method methode is verzonden.

method: String

De HTTP-methode die wordt gebruikt om de tekenreeks naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.

data: String

De tekenreeks die moet worden geüpload.

Retouren

String

Een String met het antwoord dat door de server wordt verzonden.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

method kan niet worden gebruikt om inhoud te verzenden.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u deze methode aanroept.

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

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadString(Uri, String, String)

Uploadt de opgegeven tekenreeks naar de opgegeven resource met behulp van de opgegeven methode.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::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

Parameters

address: Uri

De URI van de resource om de tekenreeks te ontvangen. Deze URI moet een resource identificeren die een aanvraag kan accepteren die met de method methode is verzonden.

method: String

De HTTP-methode die wordt gebruikt om de tekenreeks naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.

data: String

De tekenreeks die moet worden geüpload.

Retouren

String

Een String met het antwoord dat door de server wordt verzonden.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

method kan niet worden gebruikt om inhoud te verzenden.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

Feedback

Is deze pagina nuttig?