AddingNewEventArgs

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

AddingNewEventArgs クラス

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

BindingSource.AddingNew イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class AddingNewEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As AddingNewEventArgs

C#

public class AddingNewEventArgs : EventArgs

C++

public ref class AddingNewEventArgs : public
 EventArgs

J#

public class AddingNewEventArgs extends EventArgs

JScript

public class AddingNewEventArgs extends
 EventArgs

解説

AddingNewEventArgs クラスは、項目がコレクションに追加されようとしていることを通知する BindingSource.AddingNew イベントのデータを提供します。このイベントによって、オプションとして、イベント ハンドラ AddingNewEventHandler 内で、NewObject プロパティをこの新しい項目に設定することで、新しいオブジェクトを提供できます。このプロパティが設定されていない場合、コレクションは通常、適切な型の既定のコンストラクタを使用して新しい項目を作成します。どちらの場合も、新しい項目がコレクションに追加されます。

コレクションが ICancelAddNew インターフェイスも実装する場合は、項目が暫定的に追加され、後続のコミットまたはロールバックを待ちます。

このイベントは、通常、データ バインディング シナリオで、System.Windows.Forms.BindingSource や System.ComponentModel.BindingList などのクラス内で使用されます。

イベント処理の詳細については、「イベントの利用」を参照してください。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

AddingNewEventArgs クラスを使用して BindingSource.AddingNew イベントを処理する方法を示すコード例を次に示します。次のコード例は、「方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする」で示されている例の一部です。

Visual Basic

' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew(
 _
 ByVal sender As Object,
 _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

C#

// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}

C++

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}

継承階層

System.Object
   System.EventArgs
    System.ComponentModel.AddingNewEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
AddingNewEventArgs メンバ
System.ComponentModel 名前空間
AddingNewEventHandler
BindingSource.AddingNew
ICancelAddNew

AddingNewEventArgs コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

パラメータを使用せずに AddingNewEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New AddingNewEventArgs

C#

public AddingNewEventArgs ()

C++

public:
AddingNewEventArgs ()

J#

public AddingNewEventArgs ()

JScript

public function AddingNewEventArgs ()

解説

既定のコンストラクタは、NewObject プロパティを null 参照 (Visual Basic では Nothing) に設定します。値が null 参照 (Visual Basic では Nothing) の場合は、AddingNewEventHandler がこのプロパティを明示的に設定しないと、コレクションは標準の手順で新しい項目を提供し、コレクション自身に追加することを示します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
AddingNewEventArgs クラス
AddingNewEventArgs メンバ
System.ComponentModel 名前空間
NewObject
AddingNewEventHandler

AddingNewEventArgs コンストラクタ

AddingNewEventArgs クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
AddingNewEventArgs ()	パラメータを使用せずに AddingNewEventArgs クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
AddingNewEventArgs (Object)	指定したオブジェクトを新しい項目として使用して、AddingNewEventArgs クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

AddingNewEventArgs クラス
AddingNewEventArgs メンバ
System.ComponentModel 名前空間
NewObject
AddingNewEventHandler

AddingNewEventArgs コンストラクタ (Object)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定したオブジェクトを新しい項目として使用して、AddingNewEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    newObject As Object _
)

Visual Basic (使用法)

Dim newObject As Object

Dim instance As New AddingNewEventArgs(newObject)

C#

public AddingNewEventArgs (
    Object newObject
)

C++

public:
AddingNewEventArgs (
    Object^ newObject
)

J#

public AddingNewEventArgs (
    Object newObject
)

JScript

public function AddingNewEventArgs (
    newObject : Object
)

パラメータ

newObject

新しい項目値として使用する Object。

解説

AddingNewEventArgs コンストラクタは、NewObject プロパティを newObject パラメータに設定します。このオブジェクトは、このプロパティがイベント ハンドラによって更新されない限り、関連付けられているコレクションに追加する新しい項目として使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
AddingNewEventArgs クラス
AddingNewEventArgs メンバ
System.ComponentModel 名前空間
NewObject
AddingNewEventHandler

AddingNewEventArgs プロパティ

パブリック プロパティ

	名前	説明
	NewObject	バインディング リストに追加するオブジェクトを取得または設定します。

参照

関連項目

AddingNewEventArgs クラス
System.ComponentModel 名前空間
AddingNewEventHandler
BindingSource.AddingNew
ICancelAddNew

AddingNewEventArgs メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

AddingNewEventArgs クラス
System.ComponentModel 名前空間
AddingNewEventHandler
BindingSource.AddingNew
ICancelAddNew

AddingNewEventArgs メンバ

BindingSource.AddingNew イベントのデータを提供します。

AddingNewEventArgs データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	AddingNewEventArgs	オーバーロードされます。 AddingNewEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	NewObject	バインディング リストに追加するオブジェクトを取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

AddingNewEventArgs クラス
System.ComponentModel 名前空間
AddingNewEventHandler
BindingSource.AddingNew
ICancelAddNew