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 プロセスを作成する場合は、 メソッドを明示的に呼び出します。