LinqDataSource.Insert(IDictionary) メソッド

定義

挿入の操作を実行します。Performs an insert operation.

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

データ ソースに挿入する行の値。The row values to be inserted into the data source.

戻り値

挿入操作の影響を受けた行の数。The number of rows affected by the insert operation.

次の例は、ユーザーがボタンをクリックした後に、プログラムによってデータソースに新しいレコードを挿入する方法を示しています。The following example shows how to programmatically insert a new record in the data source after the user clicks a button. このコードは、既定値を含む ListDictionary オブジェクトを Insert メソッドに渡します。The code passes a ListDictionary object that contains default values to the Insert method.

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

次の例は、前の例のマークアップを示しています。The following example shows the markup for the previous example.

<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 メソッドを呼び出す必要はありません。Typically, you do not have to call the Insert method from your code. データバインドコントロールは、ユーザーが新しいレコードを挿入するアクションを実行すると、Insert メソッドを自動的に呼び出します。The data-bound control will automatically call the Insert method when the user takes action to insert a new record. データを挿入するための独自のプロセスを作成する場合は、明示的に Insert メソッドを呼び出します。You explicitly call the Insert method when you want to create your own process for inserting data.

適用対象