DataSourceView.ExecuteInsert(IDictionary) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataSourceView オブジェクトで表されたデータのリストに対して、挿入操作を実行します。
protected:
virtual int ExecuteInsert(System::Collections::IDictionary ^ values);
protected virtual int ExecuteInsert (System.Collections.IDictionary values);
abstract member ExecuteInsert : System.Collections.IDictionary -> int
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer
パラメーター
- values
- IDictionary
挿入操作で使用する名前/値ペアで構成される IDictionary。
戻り値
基になるデータ ストレージに挿入された項目数。
例外
ExecuteInsert(IDictionary) 操作は DataSourceView ではサポートされません。
例
次のコード例は、 クラスを拡張するクラスが DataSourceView プロパティと メソッドを CanInsert オーバーライドする方法を ExecuteInsert 示しています。 このコード例は、DataSourceView クラスのために提供されている大規模な例の一部です。
// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
get {
return false;
}
}
protected override int ExecuteInsert(IDictionary values)
{
throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteInsert
注釈
データ バインド コントロールは、 メソッドを使用して GetView オブジェクトをExecuteInsert取得DataSourceViewし、 プロパティを確認CanInsertすることで、操作がデータ ソース コントロールでサポートされているかどうかを判断できます。
パラメーターは values
、データ列またはフィールドと、挿入する対応する値を表す名前と値のペアのセットです。
注意
DataSourceViewクラスの既定の実装では、例外がNotSupportedExceptionスローされます。 クラスを拡張する DataSourceView 場合は、基になるデータ ストレージへの挿入がクラスでサポートされている場合は、 メソッドをオーバーライド ExecuteInsert します。
適用対象
こちらもご覧ください
.NET