WebClient.UploadString Método

  • Referencia

Definición

Espacio de nombres:
System.Net
Ensamblado:
System.Net.WebClient.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.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)

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

URI del recurso que recibirá la cadena. En el caso de los recursos HTTP, este identificador 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

String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

o bien

El parámetro data es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

No hubo 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

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

Si la BaseAddress propiedad 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 QueryString propiedad 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 cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Se aplica a

UploadString(Uri, String)

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

URI del recurso que recibirá la cadena. En el caso de los recursos HTTP, este identificador 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

String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

o bien

El parámetro data es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

No hubo respuesta del servidor que hospeda el recurso.

Comentarios

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

Si la BaseAddress propiedad 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 QueryString propiedad 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 cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Se aplica a

UploadString(String, String, String)

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);
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

URI del recurso que recibirá la cadena. Este identificador URI debe identificar un recurso que pueda aceptar una solicitud enviada con el método method.

method
String

Método HTTP utilizado 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

String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

o bien

El parámetro data es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

No hubo respuesta del servidor que hospeda el recurso.

o bien

method no puede utilizarse 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

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

Si la BaseAddress propiedad 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 QueryString propiedad no es una cadena vacía, se anexa a address.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Se aplica a

UploadString(Uri, String, String)

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);
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

URI del recurso que recibirá la cadena. Este identificador URI debe identificar un recurso que pueda aceptar una solicitud enviada con el método method.

method
String

Método HTTP utilizado 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

String que contiene la respuesta enviada por el servidor.

Excepciones

ArgumentNullException

El parámetro address es null.

o bien

El parámetro data es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

No hubo respuesta del servidor que hospeda el recurso.

o bien

method no puede utilizarse para enviar contenido.

Comentarios

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

Si la BaseAddress propiedad 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 QueryString propiedad no es una cadena vacía, se anexa a address.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Se aplica a