WebClient.UploadString Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Przekazuje określony ciąg do określonego zasobu.

Przeciążenia

UploadString(String, String)	Przekazuje określony ciąg do określonego zasobu przy użyciu metody POST.
UploadString(Uri, String)	Przekazuje określony ciąg do określonego zasobu przy użyciu metody POST.
UploadString(String, String, String)	Przekazuje określony ciąg do określonego zasobu przy użyciu określonej metody.
UploadString(Uri, String, String)	Przekazuje określony ciąg do określonego zasobu przy użyciu określonej metody.

UploadString(String, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu przy użyciu 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

Identyfikator URI zasobu do odbierania ciągu. W przypadku zasobów Http ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą metody POST, takiej jak skrypt lub strona ASP.

data

String

Ciąg do przekazania.

Zwraca

String

String zawierająca odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Przykłady

W poniższym przykładzie kodu pokazano wywołanie tej 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

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu. Aby wysłać ciąg i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadStringAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), a address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

UploadString(Uri, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu przy użyciu 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

Identyfikator URI zasobu do odbierania ciągu. W przypadku zasobów Http ten identyfikator URI musi identyfikować zasób, który może akceptować żądanie wysyłane za pomocą metody POST, takiej jak skrypt lub strona ASP.

data

String

Ciąg do przekazania.

Zwraca

String

String zawierająca odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu. Aby wysłać ciąg i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadStringAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), a address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

UploadString(String, String, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu przy użyciu określonej 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

Identyfikator URI zasobu do odbierania ciągu. Ten identyfikator URI musi zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody method.

method

String

Metoda HTTP używana do wysyłania ciągu do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i stor dla protokołu FTP.

data

String

Ciąg do przekazania.

Zwraca

String

String zawierająca odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

method nie można użyć do wysyłania zawartości.

Przykłady

W poniższym przykładzie kodu pokazano wywołanie tej 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

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu. Aby wysłać ciąg i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadStringAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

UploadString(Uri, String, String)

Źródło:

WebClient.cs

Przekazuje określony ciąg do określonego zasobu przy użyciu określonej 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

Identyfikator URI zasobu do odbierania ciągu. Ten identyfikator URI musi zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody method.

method

String

Metoda HTTP używana do wysyłania ciągu do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i stor dla protokołu FTP.

data

String

Ciąg do przekazania.

Zwraca

String

String zawierająca odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr data jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

-lub-

method nie można użyć do wysyłania zawartości.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Przed przekazaniem ciągu ta metoda konwertuje go na tablicę Byte przy użyciu kodowania określonego we właściwości Encoding. Ta metoda blokuje dane podczas przesyłania ciągu. Aby wysłać ciąg i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod UploadStringAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.