Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase AsyncCompletedEventArgs

 

Publicado: octubre de 2016

Proporciona datos para el MethodNameCompleted eventos.

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

System.Object
  System.EventArgs
    System.ComponentModel.AsyncCompletedEventArgs
      System.Activities.InvokeCompletedEventArgs
      System.ComponentModel.RunWorkerCompletedEventArgs
      System.Deployment.Application.CheckForUpdateCompletedEventArgs
      System.Deployment.Application.DownloadApplicationCompletedEventArgs
      System.Deployment.Application.DownloadFileGroupCompletedEventArgs
      System.Deployment.Application.GetManifestCompletedEventArgs
      System.Device.Location.ResolveAddressCompletedEventArgs
      System.Net.DownloadDataCompletedEventArgs
      System.Net.DownloadStringCompletedEventArgs
      System.Net.NetworkInformation.PingCompletedEventArgs
      System.Net.OpenReadCompletedEventArgs
      System.Net.OpenWriteCompletedEventArgs
      System.Net.PeerToPeer.Collaboration.CreateContactCompletedEventArgs
      System.Net.PeerToPeer.Collaboration.InviteCompletedEventArgs
      System.Net.PeerToPeer.Collaboration.RefreshDataCompletedEventArgs
      System.Net.PeerToPeer.Collaboration.SubscribeCompletedEventArgs
      System.Net.PeerToPeer.ResolveCompletedEventArgs
      System.Net.UploadDataCompletedEventArgs
      System.Net.UploadFileCompletedEventArgs
      System.Net.UploadStringCompletedEventArgs
      System.Net.UploadValuesCompletedEventArgs
      System.ServiceModel.ClientBase<TChannel>.InvokeAsyncCompletedEventArgs
      System.ServiceModel.Discovery.FindCompletedEventArgs
      System.ServiceModel.Discovery.ResolveCompletedEventArgs
      System.Speech.Recognition.EmulateRecognizeCompletedEventArgs
      System.Speech.Recognition.LoadGrammarCompletedEventArgs
      System.Speech.Recognition.RecognizeCompletedEventArgs
      System.Speech.Synthesis.PromptEventArgs
      System.Web.Services.Protocols.InvokeCompletedEventArgs
      System.Windows.Documents.GetPageCompletedEventArgs
      System.Windows.Documents.GetPageNumberCompletedEventArgs
      System.Windows.Documents.GetPageRootCompletedEventArgs
      System.Windows.Documents.Serialization.WritingCompletedEventArgs
      System.Windows.Xps.Serialization.XpsSerializationCompletedEventArgs

[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class AsyncCompletedEventArgs : EventArgs

NombreDescripción
System_CAPS_pubmethodAsyncCompletedEventArgs()

Obsoleto. Inicializa una nueva instancia de la clase AsyncCompletedEventArgs.

System_CAPS_pubmethodAsyncCompletedEventArgs(Exception, Boolean, Object)

Inicializa una nueva instancia de la clase AsyncCompletedEventArgs.

NombreDescripción
System_CAPS_pubpropertyCancelled

Obtiene un valor que indica si se ha cancelado una operación asincrónica.

System_CAPS_pubpropertyError

Obtiene un valor que indica qué error se produjo durante una operación asincrónica.

System_CAPS_pubpropertyUserState

Obtiene el identificador único para la tarea asincrónica.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodRaiseExceptionIfNecessary()

Genera una excepción proporcionada por el usuario si el error de una operación asincrónica.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

Si está utilizando una clase que implementa el Event-based Asynchronous Pattern Overview, la clase proporcionará un MethodNameCompleted eventos. Si agrega una instancia de la System.ComponentModel.AsyncCompletedEventHandler delegado al evento, recibirá información sobre el resultado de las operaciones asincrónicas en el AsyncCompletedEventArgs parámetro del método de controlador de eventos correspondiente.

Delegado de controlador de eventos de la aplicación cliente puede comprobar la Cancelled propiedad para determinar si se canceló la tarea asincrónica.

Delegado de controlador de eventos de la aplicación cliente puede comprobar la Error propiedad para determinar si se produjo una excepción durante la ejecución de la tarea asincrónica.

Si la clase admite varios métodos asincrónicos o varias llamadas al mismo método asincrónico, puede determinar qué tarea provocó el MethodNameCompleted evento comprobando el valor de la UserState propiedad. El código necesitará realizar un seguimiento de estos tokens, denominados identificadores de tarea, como sus correspondientes tareas asincrónicas iniciarse y completarse.

Notas para desarrolladores de herederos:

Las clases que siguen el modelo asincrónico basado en eventos pueden provocar eventos a los clientes de alertas sobre el estado de las operaciones asincrónicas pendientes. Si la clase proporciona un MethodNameCompleted eventos, puede usar el AsyncCompletedEventArgs para indicar a los clientes el resultado de las operaciones asincrónicas.

Desea comunicar a los clientes obtener más información acerca del resultado de una operación asincrónica que un AsyncCompletedEventArgs admite. En este caso, puede derivar su propia clase de la AsyncCompletedEventArgs clase y proporcionar variables de instancias privadas adicionales y propiedades públicas de sólo lectura correspondientes. Llame a la RaiseExceptionIfNecessary método antes de devolver el valor de propiedad, en caso de la operación se canceló o se produjo un error.

En el ejemplo de código siguiente se muestra cómo utilizar un AsyncOperation para realizar el seguimiento de la duración de las operaciones asincrónicas. Este ejemplo de código forma parte de un ejemplo mayor proporcionado para el System.ComponentModel.AsyncOperationManager clase.

using System;
using System.Collections;
using System.Collections.Specialized;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Globalization;
using System.Threading;
using System.Windows.Forms;
// This event handler updates the ListView control when the
// PrimeNumberCalculator raises the CalculatePrimeCompleted
// event. The ListView item is updated with the appropriate
// outcome of the calculation: Canceled, Error, or result.
private void primeNumberCalculator1_CalculatePrimeCompleted(
    object sender, 
    CalculatePrimeCompletedEventArgs e)
{
    Guid taskId = (Guid)e.UserState;

    if (e.Cancelled)
    {   
        string result = "Canceled";

        ListViewItem lvi = UpdateListViewItem(taskId, result);

        if (lvi != null)
        {
            lvi.BackColor = Color.Pink;
            lvi.Tag = null;
        }
    }
    else if (e.Error != null)
    {
        string result = "Error";

        ListViewItem lvi = UpdateListViewItem(taskId, result);

        if (lvi != null)
        {
            lvi.BackColor = Color.Red;
            lvi.ForeColor = Color.White;
            lvi.Tag = null;
        }
    }
    else
    {   
        bool result = e.IsPrime;

        ListViewItem lvi = UpdateListViewItem(
            taskId, 
            result, 
            e.FirstDivisor);

        if (lvi != null)
        {
            lvi.BackColor = Color.LightGray;
            lvi.Tag = null;
        }
    }
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: