WebClient.DownloadString Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Descarga el recurso solicitado como un String. El recurso que se va a descargar se puede especificar como String que contenga el URI o un Uri.

Sobrecargas

DownloadString(String)	Descarga el recurso solicitado como un String. El recurso que se va a descargar se especifica como un String que contiene el URI.
DownloadString(Uri)	Descarga el recurso solicitado como un String. El recurso que se va a descargar se especifica como un Uri.

DownloadString(String)

Source:

WebClient.cs

Descarga el recurso solicitado como un String. El recurso que se va a descargar se especifica como un String que contiene el URI.

public:
 System::String ^ DownloadString(System::String ^ address);

public string DownloadString (string address);

member this.DownloadString : string -> string

Public Function DownloadString (address As String) As String

Parámetros

address

String

Un String que contiene el URI que se va a descargar.

Devoluciones

String

Un String que contiene el recurso solicitado.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

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

-o-

Error al descargar el recurso.

NotSupportedException

Se ha llamado al método simultáneamente en varios subprocesos.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

void DownloadString( String^ address )
{
   WebClient^ client = gcnew WebClient;
   String^ reply = client->DownloadString( address );
   Console::WriteLine( reply );
}

public static void DownloadString(string address)
{
    WebClient client = new WebClient();
    string reply = client.DownloadString(address);

    Console.WriteLine(reply);
}

Public Shared Sub DownloadString(ByVal address As String)

    Dim client As WebClient = New WebClient()
    Dim reply As String = client.DownloadString(address)

    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.

Este método recupera el recurso especificado. Después de descargar el recurso, el método usa la codificación especificada en la propiedad Encoding para convertir el recurso en un String. Este método se bloquea al descargar el recurso. Para descargar un recurso y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos DownloadStringAsync.

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 RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

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.

DownloadString(Uri)

Source:

WebClient.cs

Descarga el recurso solicitado como un String. El recurso que se va a descargar se especifica como un Uri.

public:
 System::String ^ DownloadString(Uri ^ address);

public string DownloadString (Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

Parámetros

address

Uri

Objeto Uri que contiene el URI que se va a descargar.

Devoluciones

String

Un String que contiene el recurso solicitado.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

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

-o-

Error al descargar el recurso.

NotSupportedException

Se ha llamado al método simultáneamente en varios subprocesos.

Comentarios

Cautela

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

Este método recupera el recurso especificado. Después de descargar el recurso, el método usa la codificación especificada en la propiedad Encoding para convertir el recurso en un String. Este método se bloquea al descargar el recurso. Para descargar un recurso y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos DownloadStringAsync.

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 RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

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.