AsyncCompletedEventArgs.Error プロパティとは何？わかりやすく解説 Weblio辞書

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

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

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

AsyncCompletedEventArgs.Error プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

非同期操作中に発生したエラーを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Error As Exception

Visual Basic (使用法)

Dim instance As AsyncCompletedEventArgs
Dim value As Exception

value = instance.Error

public Exception Error { get; }

C++

public:
property Exception^ Error {
    Exception^ get ();
}

/** @property */
public Exception get_Error ()

JScript

public function get Error
 () : Exception

プロパティ値
非同期操作中にエラーが発生した場合は Exception インスタンス。それ以外の場合は null 参照 (Visual Basic では Nothing)。

解説

非同期操作中に例外が発生した場合、クラスは、その例外を Error プロパティに割り当てます。クライアントアプリケーションのイベントハンドラデリゲートは、AsyncCompletedEventArgs から派生したクラス内のプロパティにアクセスする前に Error プロパティをチェックする必要があります。チェックしなかった場合、プロパティは、Error への参照を保持する InnerException プロパティによって TargetInvocationException を発生させます。

継承時の注意 派生クラスで読み取り専用プロパティを提供する場合は、必ずプロパティの実装で RaiseExceptionIfNecessary メソッドを呼び出します。これにより、非同期操作でのエラーが原因で無効化されている可能性のあるプロパティにクライアントがアクセスするのを防ぐことができます。

使用例

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

Visual Basic

Imports System
Imports System.Collections
Imports System.Collections.Specialized
Imports System.ComponentModel
Imports System.Drawing
Imports System.Globalization
Imports System.Threading
Imports System.Windows.Forms
<br /><span space="preserve">...</span><br
 />    ' 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 Sub primeNumberCalculator1_CalculatePrimeCompleted(
 _
        ByVal sender As Object,
 _
        ByVal e As CalculatePrimeCompletedEventArgs)
 _
        Handles primeNumberCalculator1.CalculatePrimeCompleted

        Dim taskId As Guid = CType(e.UserState,
 Guid)

        If e.Cancelled Then
            Dim result As String
 = "Canceled"

            Dim lvi As ListViewItem = UpdateListViewItem(
 _
                taskId, _
                result)

            If Not (lvi Is
 Nothing) Then
                lvi.BackColor = Color.Pink
                lvi.Tag = Nothing
            End If

        ElseIf e.Error IsNot Nothing Then

            Dim result As String
 = "Error"

            Dim lvi As ListViewItem = UpdateListViewItem(
 _
                taskId, result)

            If Not (lvi Is
 Nothing) Then
                lvi.BackColor = Color.Red
                lvi.ForeColor = Color.White
                lvi.Tag = Nothing
            End If
        Else
            Dim result As Boolean
 = e.IsPrime

            Dim lvi As ListViewItem = UpdateListViewItem(
 _
                taskId, _
                result, _
                e.FirstDivisor)

            If Not (lvi Is
 Nothing) Then
                lvi.BackColor = Color.LightGray
                lvi.Tag = Nothing
            End If
        End If

    End Sub

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;
<br /><span space="preserve">...</span><br /> 
       // 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;
                }
            }
        }

import System.*;
import System.Collections.*;
import System.Collections.Specialized.*;
import System.ComponentModel.*;
import System.Data.*;
import System.Drawing.*;
import System.Threading.*;
import System.Windows.Forms.*;

<br /><span space="preserve">...</span><br /> 
   private void primeNumberCalculator1_CalculatePrimeCompleted(Object
 sender,
        CalculatePrimeCompletedEventArgs e)
    {
        Guid guid = (Guid)e.get_UserState();
        if (e.get_Cancelled()) {
            String result = "Cancelled";
            ListViewItem lvi = UpdateListViewItem((Guid)e.get_UserState(),
                result);
            if (lvi != null) {
                lvi.set_BackColor(Color.get_Pink());
                lvi.set_Tag(null);
            }
        }
        else {
            if (e.get_Error() != null) {
                String result = "Error";
                ListViewItem lvi = UpdateListViewItem((Guid)e.get_UserState(),
                    result);
                if (lvi != null) {
                    lvi.set_BackColor(Color.get_Red());
                    lvi.set_ForeColor(Color.get_White());
                    lvi.set_Tag(null);
                }
            }
            else {
                boolean result = e.get_IsPrime();
                ListViewItem lvi = UpdateListViewItem((Guid)e.get_UserState(),
                    result, e.get_FirstDivisor());
                if (lvi != null) {
                    lvi.set_BackColor(Color.get_LightGray());
                    lvi.set_Tag(null);
                }
            }
        }
    } //primeNumberCalculator1_CalculatePrimeCompleted

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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

全ての辞書からAsyncCompletedEventArgs.Error プロパティを検索

>> 「AsyncCompletedEventArgs.Error プロパティ」を含む用語の索引
AsyncCompletedEventArgs.Error プロパティのページへのリンク

AsyncCompletedEventArgs.Error プロパティとは？わかりやすく解説

AsyncCompletedEventArgs.Error プロパティ

「AsyncCompletedEventArgs.Error プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

AsyncCompletedEventArgs.Error プロパティとは？ わかりやすく解説

AsyncCompletedEventArgs.Error プロパティ

急上昇のことば

「AsyncCompletedEventArgs.Error プロパティ」の関連用語

AsyncCompletedEventArgs.Error プロパティとは？わかりやすく解説