ObjectDataSourceView.Update(IDictionary, IDictionary, IDictionary) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
藉由呼叫由 UpdateMethod 屬性所識別的方法,同時使用 keys
、values
或 oldValues
集合中提供的任何參數,執行更新作業。
public:
int Update(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
public int Update (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Public Function Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
參數
- keys
- IDictionary
索引鍵值的 IDictionary,用於識別要更新的項目。 這些參數與 UpdateMethod 屬性指定的方法搭配使用,以執行更新作業。 如果沒有任何參數與此方法有關聯,則會傳遞 null
。
- values
- IDictionary
要套用至資料來源之新值的 IDictionary。 這些參數與 UpdateMethod 屬性指定的方法搭配使用,以執行更新資料庫作業。 如果沒有任何參數與此方法有關聯,則會傳遞 null
。
- oldValues
- IDictionary
IDictionary,包含用於比對資料來源中之項目的其他非索引鍵值。 只有在 ConflictDetection 屬性設為 CompareAllValues 欄位時,資料列值才會傳遞至刪除方法。
傳回
更新之資料列的數目,如果數目不明,則為 -1。
備註
預設傳回值為 -1,這表示更新了未知的資料列數目。 若要傳回不同的值,請設定 AffectedRows 事件物件的 Updated 屬性 ObjectDataSourceStatusEventArgs 。 受影響的資料列數目通常是由 Update
商務物件的 方法傳回,而該值可從 ReturnValue 事件的 參數 Updated 的 屬性 ObjectDataSourceStatusEventArgs 取得。
方法會 UpdateExecuteUpdate 呼叫 方法,並 keys
傳遞 、 values
和 oldValues
參數。