AsyncCompletedEventArgs.RaiseExceptionIfNecessary Yöntem

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.ComponentModel.EventBasedAsync.dll

Kaynak:

AsyncCompletedEvent.cs

Zaman uyumsuz bir işlem başarısız olursa kullanıcı tarafından sağlanan bir özel durum oluşturur.

C#

protected void RaiseExceptionIfNecessary ();

Özel durumlar

InvalidOperationException

Cancelled özelliğidirtrue.

TargetInvocationException

Error özelliği zaman uyumsuz işlem tarafından ayarlandı. InnerException özelliği için bir başvuru barındırmaktadırError.

Örnekler

Aşağıdaki kod örneği türetilmiş sınıf özelliklerinde kullanmayı RaiseExceptionIfNecessary gösterir.

C#

public class CalculatePrimeCompletedEventArgs :
    AsyncCompletedEventArgs
{
    private int numberToTestValue = 0;
    private int firstDivisorValue = 1;
    private bool isPrimeValue;

    public CalculatePrimeCompletedEventArgs(
        int numberToTest,
        int firstDivisor,
        bool isPrime,
        Exception e,
        bool canceled,
        object state) : base(e, canceled, state)
    {
        this.numberToTestValue = numberToTest;
        this.firstDivisorValue = firstDivisor;
        this.isPrimeValue = isPrime;
    }

    public int NumberToTest
    {
        get
        {
            // Raise an exception if the operation failed or 
            // was canceled.
            RaiseExceptionIfNecessary();

            // If the operation was successful, return the 
            // property value.
            return numberToTestValue;
        }
    }

    public int FirstDivisor
    {
        get
        {
            // Raise an exception if the operation failed or 
            // was canceled.
            RaiseExceptionIfNecessary();

            // If the operation was successful, return the 
            // property value.
            return firstDivisorValue;
        }
    }

    public bool IsPrime
    {
        get
        {
            // Raise an exception if the operation failed or 
            // was canceled.
            RaiseExceptionIfNecessary();

            // If the operation was successful, return the 
            // property value.
            return isPrimeValue;
        }
    }
}

Devralanlara Notlar

Sınıfından AsyncCompletedEventArgs kendi sınıfınızı türetdiyseniz, salt okunur özelliklerinizin özellik değerini döndürmeden önce yöntemini çağırması RaiseExceptionIfNecessary() gerekir. Bileşenin zaman uyumsuz çalışan kodu özelliğine Error bir özel durum atarsa veya özelliğini olarak trueayarlarsaCancelled, istemci değerini okumayı denerse özellik bir özel durum oluşturur. Bu, istemcilerin zaman uyumsuz işlemdeki bir hata nedeniyle geçerli olmayabilecek özelliklere erişmesini engeller.

Şunlara uygulanır

Ayrıca bkz.

• AsyncOperationManager
• AsyncOperation
• Olay Tabanlı Zaman Uyumsuz Deseni Uygulama