DataSourceView.CanUpdate プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DataSourceView.CanUpdate プロパティ

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

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

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

Visual Basic (宣言)

Public Overridable ReadOnly
 Property CanUpdate As Boolean

Visual Basic (使用法)

Dim instance As DataSourceView
Dim value As Boolean

value = instance.CanUpdate

public virtual bool CanUpdate { get;
 }

C++

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

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

JScript

public function get CanUpdate
 () : boolean

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

解説

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

使用例

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

Visual Basic

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly
 Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function
 ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary,
 _
                                              oldValues As IDictionary)
 As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class 'CsvDataSourceView

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary
 keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}