WebClient.UploadString Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

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

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, jako je skript nebo stránka ASP.

data

String

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

Návraty

String

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, nebyla žá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

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během 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 UploadStringAsync metod.

Pokud vlastnost BaseAddress není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován s BaseAddress, aby se vytvořil absolutní identifikátor URI požadovaných dat. Pokud QueryString 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žije metoda POST.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

UploadString(Uri, String)

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

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, jako je skript nebo stránka ASP.

data

String

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

Návraty

String

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, nebyla žádná odpověď.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během 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 UploadStringAsync metod.

Pokud vlastnost BaseAddress není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován s BaseAddress, aby se vytvořil absolutní identifikátor URI požadovaných dat. Pokud QueryString 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žije metoda POST.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

UploadString(String, String, String)

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);

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 má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data

String

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

Návraty

String

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, nebyla žá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

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během 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 UploadStringAsync metod.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.

UploadString(Uri, String, String)

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);

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 má hodnotu null, výchozí hodnota je POST pro http a STOR pro ftp.

data

String

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

Návraty

String

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, nebyla žádná odpověď.

-nebo-

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Před nahráním řetězce ji tato metoda převede na pole Byte pomocí kódování zadaného ve vlastnosti Encoding. Tato metoda blokuje během 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 UploadStringAsync metod.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu trasování sítě v rozhraní .NET Framework.