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.

Применяется к