WebClient.UploadString Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.WebClient.dll
Zestaw:
System.dll
Zestaw:
netstandard.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
Źródło:
WebClient.cs
Ź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 zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

data
String

Ciąg do przekazania.

Zwraca

String

Element String zawierający odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to 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

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

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

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

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy

UploadString(Uri, String)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Ź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 zidentyfikować zasób, który może zaakceptować żądanie wysłane za pomocą metody POST, na przykład skryptu lub strony ASP.

data
String

Ciąg do przekazania.

Zwraca

String

Element String zawierający odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to null.

WebException

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

-lub-

Nie było odpowiedzi z serwera hostowania zasobu.

Uwagi

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

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

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

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy

UploadString(String, String, String)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Ź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);
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ą method metody .

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

Element String zawierający odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to 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żywać 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

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

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

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy

UploadString(Uri, String, String)

Źródło:
WebClient.cs
Źródło:
WebClient.cs
Ź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);
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ą method metody .

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

Element String zawierający odpowiedź wysłaną przez serwer.

Wyjątki

ArgumentNullException

Parametr address to null.

-lub-

Parametr data to 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żywać do wysyłania zawartości.

Uwagi

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

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

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy