AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

非同期操作が失敗した場合は、ユーザー指定の例外を発生させます。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub RaiseExceptionIfNecessary

Visual Basic (使用法)

Me.RaiseExceptionIfNecessary

protected void RaiseExceptionIfNecessary ()

C++

protected:
void RaiseExceptionIfNecessary ()

protected void RaiseExceptionIfNecessary ()

JScript

protected function RaiseExceptionIfNecessary
 ()

例外

例外の種類	条件
InvalidOperationException	Cancelled プロパティが true です。
TargetInvocationException	Error プロパティは、非同期操作によって設定されています。InnerException プロパティは、Error への参照を保持します。

解説

継承時の注意 AsyncCompletedEventArgs クラスから独自のクラスを派生させている場合、読み取り専用プロパティは、プロパティ値を返す前に、RaiseExceptionIfNecessary メソッドを呼び出す必要があります。コンポーネントの非同期ワーカーコードが例外を Error プロパティに割り当てている場合や Cancelled プロパティを true に設定している場合、クライアントがその値を読み取ろうとすると、プロパティは例外を発生させます。これにより、非同期操作でのエラーが原因で無効化されている可能性のあるプロパティにクライアントがアクセスするのを防ぐことができます。

使用例

AsyncOperation を使用して非同期操作の有効期間を追跡するコード例を次に示します。このコード例は、System.ComponentModel.AsyncOperationManager クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Public Class CalculatePrimeCompletedEventArgs
    Inherits AsyncCompletedEventArgs
    Private numberToTestValue As Integer
 = 0
    Private firstDivisorValue As Integer
 = 1
    Private isPrimeValue As Boolean


    Public Sub New( _
    ByVal numberToTest As Integer,
 _
    ByVal firstDivisor As Integer,
 _
    ByVal isPrime As Boolean,
 _
    ByVal e As Exception, _
    ByVal canceled As Boolean,
 _
    ByVal state As Object)

        MyBase.New(e, canceled, state)
        Me.numberToTestValue = numberToTest
        Me.firstDivisorValue = firstDivisor
        Me.isPrimeValue = isPrime

    End Sub


    Public ReadOnly Property
 NumberToTest() As Integer
        Get
            ' Raise an exception if the operation failed 
            ' or was canceled.
            RaiseExceptionIfNecessary()

            ' If the operation was successful, return 
            ' the property value.
            Return numberToTestValue
        End Get
    End Property


    Public ReadOnly Property
 FirstDivisor() As Integer
        Get
            ' Raise an exception if the operation failed 
            ' or was canceled.
            RaiseExceptionIfNecessary()

            ' If the operation was successful, return 
            ' the property value.
            Return firstDivisorValue
        End Get
    End Property


    Public ReadOnly Property
 IsPrime() As Boolean
        Get
            ' Raise an exception if the operation failed 
            ' or was canceled.
            RaiseExceptionIfNecessary()

            ' If the operation was successful, return 
            ' the property value.
            Return isPrimeValue
        End Get
    End Property
End Class

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

import System.*;
import System.Collections.*;
import System.Collections.Specialized.*;
import System.ComponentModel.*;
import System.Threading.*;
<br /><span space="preserve">...</span><br />public
 class CalculatePrimeCompletedEventArgs extends AsyncCompletedEventArgs
{
    private int numberToTestValue = 0;
    private int firstDivisorValue = 1;
    private boolean isPrimeValue;

    public CalculatePrimeCompletedEventArgs(int
 numberToTest, int firstDivisor,
        boolean isPrime, System.Exception e, boolean cancelled, Object state)
    {
        super(e, cancelled, state);
        this.numberToTestValue = numberToTest;
        this.firstDivisorValue = firstDivisor;
        this.isPrimeValue = isPrime;
    } //CalculatePrimeCompletedEventArgs

    /** @property 
     */
    public int get_NumberToTest()
    {
        // Raise an exception if the operation failed or 
        // was cancelled.
        RaiseExceptionIfNecessary();
        // If the operation was successful, return the 
        // property value.
        return numberToTestValue;
    } //get_NumberToTest

    /** @property 
     */
    public int get_FirstDivisor()
    {
        // Raise an exception if the operation failed or 
        // was cancelled.
        RaiseExceptionIfNecessary();
        // If the operation was successful, return the 
        // property value.
        return firstDivisorValue;
    } //get_FirstDivisor

    /** @property 
     */
    public boolean get_IsPrime()
    {
        // Raise an exception if the operation failed or 
        // was cancelled.
        RaiseExceptionIfNecessary();
        // If the operation was successful, return the 
        // property value.
        return isPrimeValue;
    } //get_IsPrime
} //CalculatePrimeCompletedEventArgs
<br /><span space="preserve">...</span><br />public
 class CalculatePrimeCompletedEventArgs extends AsyncCompletedEventArgs
{
    private int numberToTestValue = 0;
    private int firstDivisorValue = 1;
    private boolean isPrimeValue;

    public CalculatePrimeCompletedEventArgs(int
 numberToTest, int firstDivisor,
        boolean isPrime, System.Exception e, boolean cancelled, Object state)
    {
        super(e, cancelled, state);
        this.numberToTestValue = numberToTest;
        this.firstDivisorValue = firstDivisor;
        this.isPrimeValue = isPrime;
    } //CalculatePrimeCompletedEventArgs

    /** @property 
     */
    public int get_NumberToTest()
    {
        // Raise an exception if the operation failed or 
        // was cancelled.
        RaiseExceptionIfNecessary();
        // If the operation was successful, return the 
        // property value.
        return numberToTestValue;
    } //get_NumberToTest

    /** @property 
     */
    public int get_FirstDivisor()
    {
        // Raise an exception if the operation failed or 
        // was cancelled.
        RaiseExceptionIfNecessary();
        // If the operation was successful, return the 
        // property value.
        return firstDivisorValue;
    } //get_FirstDivisor

    /** @property 
     */
    public boolean get_IsPrime()
    {
        // Raise an exception if the operation failed or 
        // was cancelled.
        RaiseExceptionIfNecessary();
        // If the operation was successful, return the 
        // property value.
        return isPrimeValue;
    } //get_IsPrime
} //CalculatePrimeCompletedEventArgs

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
AsyncCompletedEventArgs クラス
AsyncCompletedEventArgs メンバ
System.ComponentModel 名前空間
System.ComponentModel.AsyncOperationManager
System.ComponentModel.AsyncOperation
その他の技術情報
イベントベースの非同期パターンの実装

このページでは「.NET Framework クラスライブラリリファレンス」からAsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からAsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からAsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドを検索

>> 「AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッド」を含む用語の索引
AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドのページへのリンク


	© 2025 Microsoft.All rights reserved.

AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドとは？ わかりやすく解説

AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッド

急上昇のことば

AsyncCompletedEventArgs.RaiseExceptionIfNecessary メソッドとは？わかりやすく解説