DownloadStringCompletedEventArgs Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Source:

WebClient.cs

Proporciona datos para el evento DownloadStringCompleted.

public ref class DownloadStringCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class DownloadStringCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type DownloadStringCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class DownloadStringCompletedEventArgs
Inherits AsyncCompletedEventArgs

Herencia

Object

EventArgs

AsyncCompletedEventArgs

DownloadStringCompletedEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra cómo descargar una cadena de forma asincrónica.

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
void DownloadStringInBackground2( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   // Specify that the DownloadStringCallback2 method gets called
   // when the download completes.
   client->DownloadStringCompleted += gcnew DownloadStringCompletedEventHandler( DownloadStringCallback2 );
   client->DownloadStringAsync( uri );
}

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
public static void DownloadStringInBackground2(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Specify that the DownloadStringCallback2 method gets called
    // when the download completes.
    client.DownloadStringCompleted += new DownloadStringCompletedEventHandler(DownloadStringCallback2);
    client.DownloadStringAsync(uri);
}

'  Sample call : DownloadStringInBackground2 ("http:' www.contoso.com/GameScores.html")
Public Shared Sub DownloadStringInBackground2(ByVal address As String)

    Dim client As WebClient = New WebClient()

    '  Specify that the DownloadStringCallback2 method gets called
    '  when the download completes.
    AddHandler client.DownloadStringCompleted, AddressOf DownloadStringCallback2
                Dim uri as Uri = New Uri(address)
    client.DownloadStringAsync(uri)
End Sub

Se llama al método siguiente cuando se completa la descarga.

void DownloadStringCallback2( Object^ /*sender*/, DownloadStringCompletedEventArgs^ e )
{

   // If the request was not canceled and did not throw
   // an exception, display the resource.
   if (  !e->Cancelled && e->Error == nullptr )
   {
      String^ textString = dynamic_cast<String^>(e->Result);
      Console::WriteLine( textString );
   }
}

private static void DownloadStringCallback2(Object sender, DownloadStringCompletedEventArgs e)
{
    // If the request was not canceled and did not throw
    // an exception, display the resource.
    if (!e.Cancelled && e.Error == null)
    {
        string textString = (string)e.Result;

        Console.WriteLine(textString);
    }
}

Private Shared Sub DownloadStringCallback2(ByVal sender As Object, ByVal e As DownloadStringCompletedEventArgs)

    '  If the request was not canceled and did not throw
    '  an exception, display the resource.
    If e.Cancelled = False AndAlso e.Error Is Nothing Then

        Dim textString As String = CStr(e.Result)
        Console.WriteLine(textString)
    End If
End Sub

Comentarios

Las instancias de esta clase se pasan a DownloadStringCompletedEventHandler.

Propiedades

Cancelled	Obtiene un valor que indica si se ha cancelado una operación asincrónica. (Heredado de AsyncCompletedEventArgs)
Error	Obtiene un valor que indica el error que se produjo durante una operación asincrónica. (Heredado de AsyncCompletedEventArgs)
Result	Obtiene los datos descargados por un método DownloadStringAsync.
UserState	Obtiene el identificador único de la tarea asincrónica. (Heredado de AsyncCompletedEventArgs)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
RaiseExceptionIfNecessary()	Genera una excepción proporcionada por el usuario si se ha producido un error en una operación asincrónica. (Heredado de AsyncCompletedEventArgs)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)