DataSourceView.CanInsert プロパティ

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

DataSourceView.CanInsert プロパティ

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

現在の DataSourceControl オブジェクトに関連付けられている DataSourceView オブジェクトで ExecuteInsert 操作がサポートされているかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public Overridable ReadOnly
 Property CanInsert As Boolean

Visual Basic (使用法)

Dim instance As DataSourceView
Dim value As Boolean

value = instance.CanInsert

C#

public virtual bool CanInsert { get;
 }

C++

public:
virtual property bool CanInsert {
    bool get ();
}

J#

/** @property */
public boolean get_CanInsert ()

JScript

public function get CanInsert
 () : boolean

プロパティ値
操作がサポートされている場合は true。それ以外の場合は false。基本クラスの実装では、false が返されます。

解説

CanInsert プロパティには、データ ソース コントロールの機能だけでなく、操作を実行することが現在適しているかどうかも反映されます。たとえば、データ ソース コントロールでは ExecuteInsert 操作がサポートされていますが、必須の挿入コマンドやその他のデータが設定されていない場合は挿入操作が失敗するので、CanInsert プロパティからは false が返されます。

使用例

DataSourceView クラスを拡張するクラスで、CanInsert プロパティと ExecuteInsert メソッドをオーバーライドする方法を次のコード例に示します。このコード例は、DataSourceView クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' 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

C#

// 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();
}

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
DataSourceView クラス
DataSourceView メンバ
System.Web.UI 名前空間
ExecuteInsert