DataSourceView.CanUpdate プロパティ


現在の DataSourceControl オブジェクトに関連付けられている DataSourceView オブジェクトで ExecuteUpdate(IDictionary, IDictionary, IDictionary) 操作がサポートされているかどうかを示す値を取得します。Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteUpdate(IDictionary, IDictionary, IDictionary) operation.

 virtual property bool CanUpdate { bool get(); };
public virtual bool CanUpdate { get; }
member this.CanUpdate : bool
Public Overridable ReadOnly Property CanUpdate As Boolean



操作がサポートされている場合は true。それ以外の場合は falsetrue if the operation is supported; otherwise, false. 既定の実装では、false が返されます。The default implementation returns false.

CanUpdateクラスを拡張するクラスのプロパティとメソッドをオーバーライドする方法を次のコード例に示し ExecuteUpdate DataSourceView ます。The following code example demonstrates how to override the CanUpdate property and the ExecuteUpdate method in a class that extends the DataSourceView class. このコード例は、DataSourceView クラスのために提供されている大規模な例の一部です。This code example is part of a larger example provided for the DataSourceView class.

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


プロパティは、 CanUpdate データソースコントロールの機能だけでなく、現在、操作の実行に適しているかどうかも反映します。The CanUpdate property reflects not only a capability of the data source control, but also whether it is currently appropriate to perform an operation. たとえば、データバインドコントロールが操作をサポートしていても、 ExecuteUpdate 必要な更新コマンドやその他のデータが設定されていない場合、 CanUpdate 更新操作は失敗するため、プロパティはを返し false ます。For example, even though a data-bound control supports the ExecuteUpdate operation, if a required update command or some other data is not set, the CanUpdate property returns false, as an update operation would fail.