CurrencyManager.AddNew メソッド

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

CurrencyManager.AddNew メソッド

基になるリストに新しい項目を追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub AddNew

Visual Basic (使用法)

Dim instance As CurrencyManager

instance.AddNew

C#

public override void AddNew ()

C++

public:
virtual void AddNew () override

J#

public void AddNew ()

JScript

public override function AddNew ()

例外

例外の種類	条件
NotSupportedException	基になるデータ ソースが IBindingList を実装していません。または、ユーザーが読み取り専用または固定サイズの DataView に行を追加しようとしたため、データ ソースによって例外がスローされました。

解説

このメソッドは、データ ソースが IBindingList インターフェイスを実装し、データ ソースで行を追加できる (AllowNew が true である) 場合にだけサポートされます。

メモ
このプロパティは、DataGrid コントロールなどの複合連結コントロールで、リストに新しい項目を追加できるように設計されました。

通常、このプロパティは、CurrencyManager を組み込んだ独自のコントロールを作成する場合にだけ使用します。それ以外の場合は、データ ソースが DataView ならば DataView クラスの DataView.AddNew メソッドを使用して項目を追加します。データ ソースが DataTable の場合は、NewRow メソッドを使用して、行を DataRowCollection に追加します。

使用例

AddNew メソッドを使用して、リストに新しい項目を追加するコード例を次に示します。

Visual Basic

Private Sub AddListItem()
    ' Get the CurrencyManager for a DataTable.
    Dim myCurrencyManager As CurrencyManager
 = _ 
        CType(Me.BindingContext(DataTable1), CurrencyManager)
    myCurrencyManager.AddNew()
End Sub 'AddListItem

C#

private void AddListItem()
{
   // Get the CurrencyManager for a DataTable.
   CurrencyManager myCurrencyManager = 
   (CurrencyManager)this.BindingContext[DataTable1];
   myCurrencyManager.AddNew();
}
      

C++

void AddListItem()
{
   
   // Get the CurrencyManager for a DataTable.
   CurrencyManager^ myCurrencyManager = dynamic_cast<CurrencyManager^>(this->BindingContext[
 DataTable1 ]);
   myCurrencyManager->AddNew();
}

J#

private void AddListItem()
{
    // Get the CurrencyManager for a DataTable.
    CurrencyManager myCurrencyManager = 
        (CurrencyManager)(this.get_BindingContext().get_Item(dataTable1));
    myCurrencyManager.AddNew();
} //AddListItem

JScript

private function AddListItem()
{
   // Get the CurrencyManager for a DataTable.
   var myCurrencyManager : CurrencyManager = 
   CurrencyManager(this.BindingContext[DataTable1]);
   myCurrencyManager.AddNew();
}
      

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
CurrencyManager クラス
CurrencyManager メンバ
System.Windows.Forms 名前空間
AllowNew
DataView.AddNew
NewRow