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

參數的 IDictionary 集合，與 InsertMethod 屬性搭配使用，以執行插入作業。如果沒有任何參數與此方法有關聯，則會傳遞 null。

Int32

插入之資料列的數目，如果數目不明，則為 -1。

CanInsert 屬性會傳回 false。

預設傳回值為 -1，這表示已插入未知的資料列數目。若要傳回不同的值，請設定 AffectedRows 事件物件的 Inserted 屬性 ObjectDataSourceStatusEventArgs 。受影響的資料列數目通常是由商務物件的方法傳 Insert 回，而且該值可從事件的物件的 Inserted 屬性 ObjectDataSourceStatusEventArgs 取得 ReturnValue 。

方法會 Insert 呼叫 ExecuteInsert 方法，並傳遞 values 集合。