WebClient.DownloadString Método

  • Referencia

Definición

Espacio de nombres:
System.Net
Ensamblado:
System.Net.WebClient.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Descarga el recurso solicitado como String. El recurso para descargar se puede especificar bien como una String que contiene el URI, bien como un Uri.

Sobrecargas

DownloadString(String)

Descarga el recurso solicitado como String. El recurso para descargar se especifica como una String que contiene el URI.
DownloadString(Uri)

Descarga el recurso solicitado como String. El recurso que se descarga se especifica como un Uri.

DownloadString(String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Descarga el recurso solicitado como String. El recurso para descargar se especifica como una 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

String que contiene el identificador URI para la descarga.

Devoluciones

String

Una String que contiene el recurso solicitado.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

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

o bien

Se ha producido un error al descargar el recurso.

NotSupportedException

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

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

Este método recupera el recurso especificado. Después de descargar el recurso, el método usa la codificación especificada en la Encoding propiedad para convertir el recurso en .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 DownloadStringAsync 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 RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

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

DownloadString(Uri)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Descarga el recurso solicitado como String. El recurso que se descarga 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 identificador URI para la descarga.

Devoluciones

String

Una String que contiene el recurso solicitado.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

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

o bien

Se ha producido un error al descargar el recurso.

NotSupportedException

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

Comentarios

Este método recupera el recurso especificado. Después de descargar el recurso, el método usa la codificación especificada en la Encoding propiedad para convertir el recurso en .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 DownloadStringAsync 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 RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

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