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);

參數

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

備註

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

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

注意

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

適用於

另請參閱

• CanUpdate