WebClient.UploadString Método
Definição
Carrega a cadeia de caracteres especificada no recurso especificado.Uploads the specified string to the specified resource.
Sobrecargas
| UploadString(String, String) |
Carrega a cadeia de caracteres especificada no recurso especificado, usando o método POST.Uploads the specified string to the specified resource, using the POST method. |
| UploadString(Uri, String) |
Carrega a cadeia de caracteres especificada no recurso especificado, usando o método POST.Uploads the specified string to the specified resource, using the POST method. |
| UploadString(String, String, String) |
Carrega a cadeia de caracteres dada no recurso indicado, usando o método especificado.Uploads the specified string to the specified resource, using the specified method. |
| UploadString(Uri, String, String) |
Carrega a cadeia de caracteres dada no recurso indicado, usando o método especificado.Uploads the specified string to the specified resource, using the specified method. |
UploadString(String, String)
Carrega a cadeia de caracteres especificada no recurso especificado, usando o método POST.Uploads the specified string to the specified resource, using the POST method.
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 que receberá a cadeia de caracteres.The URI of the resource to receive the string. 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.For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.
- data
- String
A cadeia de caracteres a ser carregada.The string to be uploaded.
Retornos
Um String que contém a resposta enviada pelo servidor.A String containing the response sent by the server.
Exceções
O parâmetro address é null.The address parameter is null.
- ou --or-
O parâmetro data é null.The data parameter is null.
O URI formado pela combinação de BaseAddress e address é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Não houve resposta do servidor que hospeda o recurso.There was no response from the server hosting the resource.
Exemplos
O exemplo de código a seguir demonstra como chamar esse método.The following code example demonstrates calling this method.
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
Antes de carregar a cadeia de caracteres, esse método a converte em uma Byte matriz usando a codificação especificada na Encoding propriedade.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Esse método é bloqueado enquanto a cadeia de caracteres é transmitida.This method blocks while the string is transmitted. Para enviar uma cadeia de caracteres e continuar executando enquanto aguarda a resposta do servidor, use um dos UploadStringAsync métodos.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address contiver um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será anexada address .If the QueryString property is not an empty string, it is appended to address.
Esse método usa o comando arma para carregar um recurso de FTP.This method uses the STOR command to upload an FTP resource. Para um recurso HTTP, o método POST é usado.For an HTTP resource, the POST method is used.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.
Aplica-se a
UploadString(Uri, String)
Carrega a cadeia de caracteres especificada no recurso especificado, usando o método POST.Uploads the specified string to the specified resource, using the POST method.
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 que receberá a cadeia de caracteres.The URI of the resource to receive the string. 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.For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.
- data
- String
A cadeia de caracteres a ser carregada.The string to be uploaded.
Retornos
Um String que contém a resposta enviada pelo servidor.A String containing the response sent by the server.
Exceções
O parâmetro address é null.The address parameter is null.
- ou --or-
O parâmetro data é null.The data parameter is null.
O URI formado pela combinação de BaseAddress e address é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Não houve resposta do servidor que hospeda o recurso.There was no response from the server hosting the resource.
Comentários
Antes de carregar a cadeia de caracteres, esse método a converte em uma Byte matriz usando a codificação especificada na Encoding propriedade.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Esse método é bloqueado enquanto a cadeia de caracteres é transmitida.This method blocks while the string is transmitted. Para enviar uma cadeia de caracteres e continuar executando enquanto aguarda a resposta do servidor, use um dos UploadStringAsync métodos.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address contiver um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados.If the BaseAddress property is not an empty string (""), and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será anexada address .If the QueryString property is not an empty string, it is appended to address.
Esse método usa o comando arma para carregar um recurso de FTP.This method uses the STOR command to upload an FTP resource. Para um recurso HTTP, o método POST é usado.For an HTTP resource, the POST method is used.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.
Aplica-se a
UploadString(String, String, String)
Carrega a cadeia de caracteres dada no recurso indicado, usando o método especificado.Uploads the specified string to the specified resource, using the specified method.
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
Parâmetros
- address
- String
O URI do recurso que receberá a cadeia de caracteres.The URI of the resource to receive the string. Esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método method.This URI must identify a resource that can accept a request sent with the method method.
- method
- String
O método HTTP usado para enviar a cadeia de caracteres ao recurso.The HTTP method used to send the string to the resource. Se for nulo, o padrão será POST para http e STOR para ftp.If null, the default is POST for http and STOR for ftp.
- data
- String
A cadeia de caracteres a ser carregada.The string to be uploaded.
Retornos
Um String que contém a resposta enviada pelo servidor.A String containing the response sent by the server.
Exceções
O parâmetro address é null.The address parameter is null.
- ou --or-
O parâmetro data é null.The data parameter is null.
O URI formado pela combinação de BaseAddress e address é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Não houve resposta do servidor que hospeda o recurso.There was no response from the server hosting the resource.
- ou --or-
method não pode ser usado para enviar o conteúdo.method cannot be used to send content.
Exemplos
O exemplo de código a seguir demonstra como chamar esse método.The following code example demonstrates calling this method.
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
Antes de carregar a cadeia de caracteres, esse método a converte em uma Byte matriz usando a codificação especificada na Encoding propriedade.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Esse método é bloqueado enquanto a cadeia de caracteres é transmitida.This method blocks while the string is transmitted. Para enviar uma cadeia de caracteres e continuar executando enquanto aguarda a resposta do servidor, use um dos UploadStringAsync métodos.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address contiver um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será anexada address .If the QueryString property is not an empty string, it is appended to address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.
Aplica-se a
UploadString(Uri, String, String)
Carrega a cadeia de caracteres dada no recurso indicado, usando o método especificado.Uploads the specified string to the specified resource, using the specified method.
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
Parâmetros
- address
- Uri
O URI do recurso que receberá a cadeia de caracteres.The URI of the resource to receive the string. Esse URI deve identificar um recurso que pode aceitar uma solicitação enviada com o método method.This URI must identify a resource that can accept a request sent with the method method.
- method
- String
O método HTTP usado para enviar a cadeia de caracteres ao recurso.The HTTP method used to send the string to the resource. Se for nulo, o padrão será POST para http e STOR para ftp.If null, the default is POST for http and STOR for ftp.
- data
- String
A cadeia de caracteres a ser carregada.The string to be uploaded.
Retornos
Um String que contém a resposta enviada pelo servidor.A String containing the response sent by the server.
Exceções
O parâmetro address é null.The address parameter is null.
- ou --or-
O parâmetro data é null.The data parameter is null.
O URI formado pela combinação de BaseAddress e address é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Não houve resposta do servidor que hospeda o recurso.There was no response from the server hosting the resource.
- ou --or-
method não pode ser usado para enviar o conteúdo.method cannot be used to send content.
Comentários
Antes de carregar a cadeia de caracteres, esse método a converte em uma Byte matriz usando a codificação especificada na Encoding propriedade.Before uploading the string, this method converts it to a Byte array using the encoding specified in the Encoding property. Esse método é bloqueado enquanto a cadeia de caracteres é transmitida.This method blocks while the string is transmitted. Para enviar uma cadeia de caracteres e continuar executando enquanto aguarda a resposta do servidor, use um dos UploadStringAsync métodos.To send a string and continue executing while waiting for the server's response, use one of the UploadStringAsync methods.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address contiver um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será anexada address .If the QueryString property is not an empty string, it is appended to address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.