LinqDataSource.Insert(IDictionary) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

執行插入作業。

public:
 int Insert(System::Collections::IDictionary ^ values);

public int Insert (System.Collections.IDictionary values);

member this.Insert : System.Collections.IDictionary -> int

Public Function Insert (values As IDictionary) As Integer

參數

values

IDictionary

要插入資料來源的資料列值。

傳回

Int32

插入作業所影響的資料列數目。

範例

下列範例示範如何在使用者按一下按鈕之後，以程式設計方式在資料來源中插入新記錄。 程式碼會將包含預設值的 物件傳遞 ListDictionary 至 Insert 方法。

protected void Add_Click(object sender, EventArgs e)
{
    System.Collections.Specialized.ListDictionary listDictionary
        = new System.Collections.Specialized.ListDictionary();
    listDictionary.Add("ProductName", TextBox1.Text);
    listDictionary.Add("ProductCategory", "General");
    listDictionary.Add("Color", "Not assigned");
    listDictionary.Add("ListPrice", null);
    LinqDataSource1.Insert(listDictionary);

    TextBox1.Text = String.Empty;
    DetailsView1.DataBind();
}

Protected Sub Add_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim listDictionary As New System.Collections.Specialized.ListDictionary()
    listDictionary.Add("ProductName", TextBox1.Text)
    listDictionary.Add("ProductCategory", "General")
    listDictionary.Add("Color", "Not assigned")
    listDictionary.Add("ListPrice", Nothing)
    LinqDataSource1.Insert(listDictionary)

    TextBox1.Text = String.Empty
    DetailsView1.DataBind()
End Sub

下列範例顯示上一個範例的標記。

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  EnableInsert="true" 
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
  DataSourceID="LinqDataSource1" 
  AllowPaging="true" 
  ID="DetailsView1" 
  runat="server">
</asp:DetailsView>
New product name:<br />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<br />
<asp:button ID="Button1" 
  Text="Add new product with default values" 
  runat="server" 
  onclick="Add_Click" />

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  EnableInsert="true" 
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
  DataSourceID="LinqDataSource1" 
  AllowPaging="true" 
  ID="DetailsView1" 
  runat="server">
</asp:DetailsView>
New product name:<br />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<br />
<asp:button ID="Button1" 
  Text="Add new product with default values" 
  runat="server" 
  onclick="Add_Click" />

備註

一般而言，您不需要從程式碼呼叫 Insert 方法。 當使用者採取動作插入新記錄時，資料繫結控制項會自動呼叫 Insert 方法。 當您想要建立自己的程式來插入資料時，您會明確地呼叫 Insert 方法。