LinqDataSource.Insert(IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию вставки.
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
Значения строк, которые вносятся в источник данных.
Возвращаемое значение
Количество строк, на которые повлияла операция вставки.
Примеры
В следующем примере показано, как программно вставить новую запись в источник данных после нажатия пользователем кнопки. Код передает 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 образом, если требуется создать собственный процесс для вставки данных.