ObjectDataSourceView.Insert(IDictionary) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
藉由呼叫由 InsertMethod 屬性所識別的商務物件方法,同時使用指定的 values
集合,執行插入作業。
public:
int Insert(System::Collections::IDictionary ^ values);
public int Insert (System.Collections.IDictionary values);
override this.Insert : System.Collections.IDictionary -> int
Public Function Insert (values As IDictionary) As Integer
參數
- values
- IDictionary
參數的 IDictionary 集合,與 InsertMethod 屬性搭配使用,以執行插入作業。 如果沒有任何參數與此方法有關聯,則會傳遞 null
。
傳回
插入之資料列的數目,如果數目不明,則為 -1。
例外狀況
CanInsert 屬性會傳回 false
。
備註
預設傳回值為 -1,這表示已插入未知的資料列數目。 若要傳回不同的值,請設定 AffectedRows 事件物件的 Inserted 屬性 ObjectDataSourceStatusEventArgs 。 受影響的資料列數目通常是由商務物件的 方法傳 Insert
回,而且該值可從事件的 物件的 Inserted 屬性 ObjectDataSourceStatusEventArgs 取得 ReturnValue 。
方法會 Insert 呼叫 ExecuteInsert 方法,並傳遞 values
集合。