DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

在 DataSourceView 物件表示的資料清單上，執行更新作業。

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);

protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

參數

keys

IDictionary

更新作業將更新的物件或資料列索引鍵 IDictionary。

values

IDictionary

名稱/值組的 IDictionary，表示資料項目及其新值。

oldValues

IDictionary

名稱/值組的 IDictionary，表示資料項目及其原始值。

傳回

Int32

在基礎資料儲存區中更新的項目數目。

例外狀況

NotSupportedException

ExecuteUpdate(IDictionary, IDictionary, IDictionary) 不支援 DataSourceView 作業。

範例

下列程式碼範例示範擴充 DataSourceView 類別的類別如何覆寫 CanUpdate 屬性和 ExecuteUpdate 方法。 此程式碼範例是提供給 類別之較大範例的 DataSourceView 一部分。

// 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
      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

備註

資料繫結控制項可以使用 方法來擷取 DataSourceView 物件並檢查 CanUpdate 屬性值，判斷資料來源控制項 DataSourceControl.GetView 是否 ExecuteUpdate 支援作業。

參數 keys 代表要更新之資料的物件或資料列索引鍵。 對於代表關聯式資料的資料來源，例如 SqlDataSource 控制項， keys 參數是資料庫主鍵的集合。 在其他情況下， keys 參數是名稱/值組的集合，可用來篩選資料清單。 任何符合名稱/值組的資料都會更新為 參數中找到 values 的值，這是一組名稱/值組，代表現有欄位或資料行的新值。

注意

類別 DataSourceView 的預設實作是擲回例外狀況 NotSupportedException 。 如果您擴充 DataSourceView 類別，如果您的類別支援更新基礎資料儲存體中的資料，請覆寫 ExecuteUpdate 方法。

另請參閱

• CanUpdate