WebClient.UploadString Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Feltölti a megadott sztringet a megadott erőforrásba.

Túlterhelések

Name	Description
UploadString(String, String)	Feltölti a megadott sztringet a megadott erőforrásba a POST metódus használatával.
UploadString(Uri, String)	Feltölti a megadott sztringet a megadott erőforrásba a POST metódus használatával.
UploadString(String, String, String)	Feltölti a megadott sztringet a megadott erőforrásba a megadott módszerrel.
UploadString(Uri, String, String)	Feltölti a megadott sztringet a megadott erőforrásba a megadott módszerrel.

UploadString(String, String)

Forrás:

WebClient.cs

Feltölti a megadott sztringet a megadott erőforrásba a POST metódus használatával.

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éterek

address

String

A sztring fogadásához az erőforrás URI-ja. Http-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

data

String

A feltöltendő sztring.

Válaszok

String

A String kiszolgáló által küldött választ tartalmazó üzenet.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Példák

Az alábbi példakód bemutatja a metódus meghívását.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét. Ha sztringet szeretne küldeni, és a kiszolgáló válaszára várva folytatja a végrehajtást, használja az egyik metódust UploadStringAsync .

Ha a BaseAddress tulajdonság nem üres sztring (""), és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadString(Uri, String)

Forrás:

WebClient.cs

Feltölti a megadott sztringet a megadott erőforrásba a POST metódus használatával.

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éterek

address

Uri

A sztring fogadásához az erőforrás URI-ja. Http-erőforrások esetén ennek az URI-nak azonosítania kell egy olyan erőforrást, amely képes fogadni a POST metódussal küldött kérést, például egy szkriptet vagy egy ASP-lapot.

data

String

A feltöltendő sztring.

Válaszok

String

A String kiszolgáló által küldött választ tartalmazó üzenet.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét. Ha sztringet szeretne küldeni, és a kiszolgáló válaszára várva folytatja a végrehajtást, használja az egyik metódust UploadStringAsync .

Ha a BaseAddress tulajdonság nem üres sztring (""), és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadString(String, String, String)

Forrás:

WebClient.cs

Feltölti a megadott sztringet a megadott erőforrásba a megadott módszerrel.

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

Paraméterek

address

String

A sztring fogadásához az erőforrás URI-ja. Ennek az URI-nak azonosítania kell egy erőforrást, amely képes elfogadni a metódussal küldött kérést method .

method

String

A sztring erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

data

String

A feltöltendő sztring.

Válaszok

String

A String kiszolgáló által küldött választ tartalmazó üzenet.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

-vagy-

method nem használható tartalom küldésére.

Példák

Az alábbi példakód bemutatja a metódus meghívását.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét. Ha sztringet szeretne küldeni, és a kiszolgáló válaszára várva folytatja a végrehajtást, használja az egyik metódust UploadStringAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadString(Uri, String, String)

Forrás:

WebClient.cs

Feltölti a megadott sztringet a megadott erőforrásba a megadott módszerrel.

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

Paraméterek

address

Uri

A sztring fogadásához az erőforrás URI-ja. Ennek az URI-nak azonosítania kell egy erőforrást, amely képes elfogadni a metódussal küldött kérést method .

method

String

A sztring erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

data

String

A feltöltendő sztring.

Válaszok

String

A String kiszolgáló által küldött választ tartalmazó üzenet.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

-vagy-

A data paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

-vagy-

method nem használható tartalom küldésére.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A sztring feltöltése előtt ez a metódus tömbté alakítja Byte a Encoding tulajdonságban megadott kódolással. Ez a metódus blokkolja a sztring átvitelét. Ha sztringet szeretne küldeni, és a kiszolgáló válaszára várva folytatja a végrehajtást, használja az egyik metódust UploadStringAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.