CurrencyManager.AddNew CurrencyManager.AddNew CurrencyManager.AddNew CurrencyManager.AddNew Method

定義

基になるリストに新しい項目を追加します。Adds a new item to the underlying list.

public:
 override void AddNew();
public override void AddNew ();
override this.AddNew : unit -> unit
Public Overrides Sub AddNew ()

例外

基になるデータ ソースが IBindingList を実装していません。または、ユーザーが読み取り専用または固定サイズの DataView に行を追加しようとしたため、データ ソースによって例外がスローされました。The underlying data source does not implement IBindingList, or the data source has thrown an exception because the user has attempted to add a row to a read-only or fixed-size DataView.

次のコード例では、 AddNewメソッドを使用して、リストに新しい項目を追加します。The following code example adds a new item to the list with the AddNew method.

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

private void AddListItem()
{
   // Get the CurrencyManager for a DataTable.
   CurrencyManager myCurrencyManager = 
   (CurrencyManager)this.BindingContext[DataTable1];
   myCurrencyManager.AddNew();
}
      
Private Sub AddListItem()
    ' Get the CurrencyManager for a DataTable.
    Dim myCurrencyManager As CurrencyManager = _ 
        CType(Me.BindingContext(DataTable1), CurrencyManager)
    myCurrencyManager.AddNew()
End Sub

注釈

このメソッドは、データソースがIBindingListインターフェイスを実装し、データソースで行の追加が許可されている (AllowNewtrue) 場合にのみサポートされます。This method is supported only if the data source implements the IBindingList interface and the data source allows adding rows (AllowNew is true).

注意

このプロパティは、 DataGridコントロールなどの複合コントロールで新しい項目をリストに追加できるように設計されています。This property was designed to allow complex-bound controls, such as the DataGrid control, to add new items to list.

このプロパティは、通常、を組み込む独自のCurrencyManagerコントロールを作成する場合にのみ使用します。You typically use this property only if you are creating your own control that incorporates the CurrencyManager. それ以外の場合、データソースがDataViewである場合に項目を追加するには、 DataViewクラスのDataView.AddNewメソッドを使用します。Otherwise, to add items if the data source is a DataView, use the DataView.AddNew method of the DataView class. データソースがのDataTable場合は、 NewRowメソッドを使用し、に行をDataRowCollection追加します。If the data source is a DataTable, use the NewRow method and add the row to the DataRowCollection.

適用対象

こちらもご覧ください