WebClient.UploadString Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Carrega a cadeia de caracteres especificada para o recurso especificado.

Sobrecargas

UploadString(String, String)	Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método POST.
UploadString(Uri, String)	Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método POST.
UploadString(String, String, String)	Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método especificado.
UploadString(Uri, String, String)	Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método especificado.

UploadString(String, String)

Origem:

WebClient.cs

Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método 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

Parâmetros

address

String

O URI do recurso para receber a cadeia de caracteres. Para recursos Http, esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método POST, como um script ou uma página ASP.

data

String

A cadeia de caracteres a ser carregada.

Retornos

String

Um String que contém a resposta enviada pelo servidor.

Exceções

ArgumentNullException

O parâmetro address é null.

-ou-

O parâmetro data é null.

WebException

O URI formado pela combinação de BaseAddress e address é inválido.

-ou-

Não houve resposta do servidor que hospeda o recurso.

Exemplos

O exemplo de código a seguir demonstra a chamada desse método.

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

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Antes de carregar a cadeia de caracteres, esse método a converte em uma matriz de Byte usando a codificação especificada na propriedade Encoding. Esse método bloqueia enquanto a cadeia de caracteres é transmitida. Para enviar uma cadeia de caracteres e continuar a execução enquanto aguarda a resposta do servidor, use um dos métodos UploadStringAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia (""), e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

UploadString(Uri, String)

Origem:

WebClient.cs

Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método 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

Parâmetros

address

Uri

O URI do recurso para receber a cadeia de caracteres. Para recursos Http, esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método POST, como um script ou uma página ASP.

data

String

A cadeia de caracteres a ser carregada.

Retornos

String

Um String que contém a resposta enviada pelo servidor.

Exceções

ArgumentNullException

O parâmetro address é null.

-ou-

O parâmetro data é null.

WebException

O URI formado pela combinação de BaseAddress e address é inválido.

-ou-

Não houve resposta do servidor que hospeda o recurso.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Antes de carregar a cadeia de caracteres, esse método a converte em uma matriz de Byte usando a codificação especificada na propriedade Encoding. Esse método bloqueia enquanto a cadeia de caracteres é transmitida. Para enviar uma cadeia de caracteres e continuar a execução enquanto aguarda a resposta do servidor, use um dos métodos UploadStringAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia (""), e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

UploadString(String, String, String)

Origem:

WebClient.cs

Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método especificado.

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

Parâmetros

address

String

O URI do recurso para receber a cadeia de caracteres. Esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método method.

method

String

O método HTTP usado para enviar a cadeia de caracteres para o recurso. Se nulo, o padrão será POST para http e STOR para ftp.

data

String

A cadeia de caracteres a ser carregada.

Retornos

String

Um String que contém a resposta enviada pelo servidor.

Exceções

ArgumentNullException

O parâmetro address é null.

-ou-

O parâmetro data é null.

WebException

O URI formado pela combinação de BaseAddress e address é inválido.

-ou-

Não houve resposta do servidor que hospeda o recurso.

-ou-

method não pode ser usado para enviar conteúdo.

Exemplos

O exemplo de código a seguir demonstra a chamada desse método.

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

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Antes de carregar a cadeia de caracteres, esse método a converte em uma matriz de Byte usando a codificação especificada na propriedade Encoding. Esse método bloqueia enquanto a cadeia de caracteres é transmitida. Para enviar uma cadeia de caracteres e continuar a execução enquanto aguarda a resposta do servidor, use um dos métodos UploadStringAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

UploadString(Uri, String, String)

Origem:

WebClient.cs

Carrega a cadeia de caracteres especificada para o recurso especificado, usando o método especificado.

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

Parâmetros

address

Uri

O URI do recurso para receber a cadeia de caracteres. Esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método method.

method

String

O método HTTP usado para enviar a cadeia de caracteres para o recurso. Se nulo, o padrão será POST para http e STOR para ftp.

data

String

A cadeia de caracteres a ser carregada.

Retornos

String

Um String que contém a resposta enviada pelo servidor.

Exceções

ArgumentNullException

O parâmetro address é null.

-ou-

O parâmetro data é null.

WebException

O URI formado pela combinação de BaseAddress e address é inválido.

-ou-

Não houve resposta do servidor que hospeda o recurso.

-ou-

method não pode ser usado para enviar conteúdo.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Antes de carregar a cadeia de caracteres, esse método a converte em uma matriz de Byte usando a codificação especificada na propriedade Encoding. Esse método bloqueia enquanto a cadeia de caracteres é transmitida. Para enviar uma cadeia de caracteres e continuar a execução enquanto aguarda a resposta do servidor, use um dos métodos UploadStringAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for uma cadeia de caracteres vazia, ela será acrescentada a address.

Nota

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.