WebClient.UploadString Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Carga la cadena especificada en el recurso especificado.

Sobrecargas

UploadString(String, String)	Carga la cadena especificada en el recurso especificado mediante el método POST.
UploadString(Uri, String)	Carga la cadena especificada en el recurso especificado mediante el método POST.
UploadString(String, String, String)	Carga la cadena especificada en el recurso especificado mediante el método especificado.
UploadString(Uri, String, String)	Carga la cadena especificada en el recurso especificado mediante el método especificado.

UploadString(String, String)

Source:

WebClient.cs

Carga la cadena especificada en el recurso especificado mediante el 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

Identificador URI del recurso que se va a recibir la cadena. En el caso de los recursos Http, este URI debe identificar un recurso que pueda aceptar una solicitud enviada con el método POST, como un script o una página ASP.

data

String

Cadena que se va a cargar.

Devoluciones

String

Un String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

-o-

El parámetro data es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

No se ha producido ninguna respuesta del servidor que hospeda el recurso.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este 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

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Antes de cargar la cadena, este método lo convierte en una matriz de Byte mediante la codificación especificada en la propiedad Encoding. Este método bloquea mientras se transmite la cadena. Para enviar una cadena y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos UploadStringAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Este método usa el comando STOR para cargar un recurso FTP. Para un recurso HTTP, se usa el método POST.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

UploadString(Uri, String)

Source:

WebClient.cs

Carga la cadena especificada en el recurso especificado mediante el 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

Identificador URI del recurso que se va a recibir la cadena. En el caso de los recursos Http, este URI debe identificar un recurso que pueda aceptar una solicitud enviada con el método POST, como un script o una página ASP.

data

String

Cadena que se va a cargar.

Devoluciones

String

Un String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

-o-

El parámetro data es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

No se ha producido ninguna respuesta del servidor que hospeda el recurso.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Antes de cargar la cadena, este método lo convierte en una matriz de Byte mediante la codificación especificada en la propiedad Encoding. Este método bloquea mientras se transmite la cadena. Para enviar una cadena y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos UploadStringAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Este método usa el comando STOR para cargar un recurso FTP. Para un recurso HTTP, se usa el método POST.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

UploadString(String, String, String)

Source:

WebClient.cs

Carga la cadena especificada en el recurso especificado mediante el 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

Identificador URI del recurso que se va a recibir la cadena. Este URI debe identificar un recurso que pueda aceptar una solicitud enviada con el método method.

method

String

Método HTTP que se usa para enviar la cadena al recurso. Si es null, el valor predeterminado es POST para http y STOR para ftp.

data

String

Cadena que se va a cargar.

Devoluciones

String

Un String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

-o-

El parámetro data es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

No se ha producido ninguna respuesta del servidor que hospeda el recurso.

-o-

method no se puede usar para enviar contenido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este 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

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Antes de cargar la cadena, este método lo convierte en una matriz de Byte mediante la codificación especificada en la propiedad Encoding. Este método bloquea mientras se transmite la cadena. Para enviar una cadena y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos UploadStringAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

UploadString(Uri, String, String)

Source:

WebClient.cs

Carga la cadena especificada en el recurso especificado mediante el 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

Identificador URI del recurso que se va a recibir la cadena. Este URI debe identificar un recurso que pueda aceptar una solicitud enviada con el método method.

method

String

Método HTTP que se usa para enviar la cadena al recurso. Si es null, el valor predeterminado es POST para http y STOR para ftp.

data

String

Cadena que se va a cargar.

Devoluciones

String

Un String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

-o-

El parámetro data es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

No se ha producido ninguna respuesta del servidor que hospeda el recurso.

-o-

method no se puede usar para enviar contenido.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Antes de cargar la cadena, este método lo convierte en una matriz de Byte mediante la codificación especificada en la propiedad Encoding. Este método bloquea mientras se transmite la cadena. Para enviar una cadena y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos UploadStringAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.