Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

AsyncCompletedEventArgs (Clase)

Proporciona datos para el evento Completed de nombreDeMétodo.

System.Object
  System.EventArgs
    System.ComponentModel.AsyncCompletedEventArgs
      Más...

Espacio de nombres:  System.ComponentModel
Ensamblado:  System (en System.dll)
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class AsyncCompletedEventArgs : EventArgs

El tipo AsyncCompletedEventArgs expone los siguientes miembros.

  NombreDescripción
Método públicoAsyncCompletedEventArgs() Obsoleto. Inicializa una nueva instancia de la clase AsyncCompletedEventArgs.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAsyncCompletedEventArgs(Exception, Boolean, Object)Inicializa una nueva instancia de la clase AsyncCompletedEventArgs.
Arriba
  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCancelledObtiene un valor que indica si se ha cancelado una operación asincrónica.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsErrorObtiene un valor que indica el error que se produjo durante una operación asincrónica.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsUserStateObtiene el identificador único de la tarea asincrónica.
Arriba
  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsRaiseExceptionIfNecessaryGenera una excepción proporcionada por el usuario si se ha producido un error en una operación asincrónica.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

Si está utilizando una clase que implementa Información general sobre el modelo asincrónico basado en eventos, la clase proporcionará un evento nombreDeMétodoCompleted. Si agrega una instancia del delegado System.ComponentModel.AsyncCompletedEventHandler al evento, recibirá información sobre el resultado de las operaciones asincrónicas en el parámetro AsyncCompletedEventArgs del método de control de eventos correspondiente.

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

El delegado del controlador de eventos de la aplicación cliente puede comprobar la propiedad Error 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, se puede determinar qué tarea provocó el evento Completed de MethodName comprobando el valor de la propiedad UserState. Es necesario que el código realice un seguimiento de estos símbolos (token), a los que se conoce como id. de tarea, a medida que sus tareas asincrónicas correspondientes van inicializándose y finalizando.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el valor de propiedad Resources siguiente: SharedState. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

Notas para los herederos

Las clases que siguen el Modelo asincrónico basado en evento pueden generar eventos para avisar a los clientes del estado de las operaciones asincrónicas pendientes. Si la clase proporciona un evento Completed de MethodName, puede utilizar AsyncCompletedEventArgs para indicar a los clientes el resultado de las operaciones asincrónicas.

Es posible que desee proporcionar a los clientes más información sobre el resultado de una operación asincrónica que la que se incluye en un objeto AsyncCompletedEventArgs. En este caso, puede derivar una clase propia de la clase AsyncCompletedEventArgs y proporcionar variables de instancias privadas adicionales, así como las propiedades públicas de sólo lectura correspondientes. En caso de que se haya cancelado la operación o de que se haya producido un error, hay que llamar al método RaiseExceptionIfNecessary antes de devolver el valor de propiedad.

En el siguiente ejemplo de código se muestra la forma de utilizar un objeto AsyncOperation para realizar un seguimiento de la duración de las operaciones asincrónicas. Este ejemplo de código forma parte de un ejemplo más extenso referente a la clase System.ComponentModel.AsyncOperationManager.


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


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.