Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe AsyncCompletedEventArgs

 

Fornece dados para o evento MethodNameCompleted.

Namespace:   System.ComponentModel
Assembly:  System (em 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

NomeDescrição
System_CAPS_pubmethodAsyncCompletedEventArgs()

Obsoleto. Inicializa uma nova instância da classe AsyncCompletedEventArgs.

System_CAPS_pubmethodAsyncCompletedEventArgs(Exception, Boolean, Object)

Inicializa uma nova instância da classe AsyncCompletedEventArgs.

NomeDescrição
System_CAPS_pubpropertyCancelled

Obtém um valor que indica se uma operação assíncrona foi cancelada.

System_CAPS_pubpropertyError

Obtém um valor que indica qual erro ocorreu durante uma operação assíncrona.

System_CAPS_pubpropertyUserState

Obtém o identificador exclusivo para a tarefa assíncrona.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodRaiseExceptionIfNecessary()

Gera uma exceção fornecida pelo usuário se uma operação assíncrona falhou.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

If you are using a class that implements the Event-based Asynchronous Pattern Overview, the class will provide a MethodNameCompleted event. If you add an instance of the T:System.ComponentModel.AsyncCompletedEventHandler delegate to the event, you will receive information about the outcome of asynchronous operations in the T:System.ComponentModel.AsyncCompletedEventArgs parameter of the corresponding event-handler method.

The client application's event-handler delegate can check the P:System.ComponentModel.AsyncCompletedEventArgs.Cancelled property to determine if the asynchronous task was cancelled.

The client application's event-handler delegate can check the P:System.ComponentModel.AsyncCompletedEventArgs.Error property to determine if an exception occurred during execution of the asynchronous task.

If the class supports multiple asynchronous methods, or multiple calls to the same asynchronous method, you can determine which task raised the MethodNameCompleted event by checking the value of the P:System.ComponentModel.AsyncCompletedEventArgs.UserState property. Your code will need to track these tokens, known as task IDs, as their corresponding asynchronous tasks start and complete.

Observações para os Herdeiros:

Classes that follow the Event-based Asynchronous Pattern can raise events to alert clients about the status of pending asynchronous operations. If the class provides a MethodNameCompleted event, you can use the T:System.ComponentModel.AsyncCompletedEventArgs to tell clients about the outcome of asynchronous operations.

You may want to communicate to clients more information about the outcome of an asynchronous operation than an T:System.ComponentModel.AsyncCompletedEventArgs accommodates. In this case, you can derive your own class from the T:System.ComponentModel.AsyncCompletedEventArgs class and provide additional private instance variables and corresponding read-only public properties. Call the M:System.ComponentModel.AsyncCompletedEventArgs.RaiseExceptionIfNecessary method before returning the property value, in case the operation was canceled or an error occurred.

The following code example demonstrates using an T:System.ComponentModel.AsyncOperation to track the lifetime of asynchronous operations. This code example is part of a larger example provided for the T:System.ComponentModel.AsyncOperationManager class.

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 do Windows
Disponível desde 8
.NET Framework
Disponível desde 2.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: