WebClient.UploadString Metoda

Reference

Definice

Obor názvů:: System.Net

Sestavení:: System.Net.WebClient.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nahraje zadaný řetězec do zadaného prostředku.

Přetížení

UploadString(String, String)	Nahraje zadaný řetězec do zadaného prostředku pomocí metody POST.
UploadString(Uri, String)	Nahraje zadaný řetězec do zadaného prostředku pomocí metody POST.
UploadString(String, String, String)	Nahraje zadaný řetězec do zadaného prostředku pomocí zadané metody.
UploadString(Uri, String, String)	Nahraje zadaný řetězec do zadaného prostředku pomocí zadané metody.

UploadString(String, String)

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku pomocí metody 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

Parametry

address: String

Identifikátor URI prostředku pro příjem řetězce U prostředků HTTP musí tento identifikátor URI identifikovat prostředek, který může přijmout požadavek odeslaný metodou POST, například skript nebo stránku ASP.

data: String

Řetězec, který se má nahrát.

Návraty

String

A String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.

Příklady

Následující příklad kódu ukazuje volání této metody.

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

Poznámky

Před nahráním řetězce ho tato metoda převede na Byte pole pomocí kódování zadaného Encoding ve vlastnosti. Tato metoda blokuje při přenosu řetězce. Pokud chcete odeslat řetězec a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z těchto UploadStringAsync metod.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address.

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se používá metoda POST.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro

UploadString(Uri, String)

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku pomocí metody 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

Parametry

address: Uri

data: String

Řetězec, který se má nahrát.

Návraty

String

A String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.

Poznámky

Tato metoda používá příkaz STOR k nahrání prostředku FTP. Pro prostředek HTTP se používá metoda POST.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro

UploadString(String, String, String)

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku pomocí zadané metody.

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

Parametry

address: String

Identifikátor URI prostředku pro příjem řetězce Tento identifikátor URI musí identifikovat prostředek, který může přijmout požadavek odeslaný metodou method .

method: String

Metoda HTTP použitá k odeslání řetězce do prostředku. Pokud je null, výchozí hodnota je POST pro http a STOR pro ftp.

data: String

Řetězec, který se má nahrát.

Návraty

String

A String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.

-nebo-

method nelze použít k odesílání obsahu.

Příklady

Následující příklad kódu ukazuje volání této metody.

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

Poznámky

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro

UploadString(Uri, String, String)

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Zdroj:: WebClient.cs

Nahraje zadaný řetězec do zadaného prostředku pomocí zadané metody.

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

Parametry

address: Uri

Identifikátor URI prostředku pro příjem řetězce Tento identifikátor URI musí identifikovat prostředek, který může přijmout požadavek odeslaný metodou method .

method: String

Metoda HTTP použitá k odeslání řetězce do prostředku. Pokud je null, výchozí hodnota je POST pro http a STOR pro ftp.

data: String

Řetězec, který se má nahrát.

Návraty

String

A String obsahující odpověď odeslanou serverem.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr data je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Ze serveru, který je hostitelem prostředku, nepřišla žádná odpověď.

-nebo-

method nelze použít k odesílání obsahu.

Poznámky

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro

WebClient.UploadString Metoda

Definice

Přetížení

UploadString(String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

UploadString(Uri, String)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

UploadString(String, String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

UploadString(Uri, String, String)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Váš názor

Další materiály