LinqDataSource.Insert(IDictionary) Methode

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Führt einen Einfügevorgang aus.

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

Parameter

values

IDictionary

Die Zeilenwerte, die in die Datenquelle eingefügt werden sollen.

Gibt zurück

Int32

Die Anzahl der vom Einfügevorgang betroffenen Zeilen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie einen neuen Datensatz programmgesteuert in die Datenquelle einfügen, nachdem der Benutzer auf eine Schaltfläche klickt. Der Code übergibt ein ListDictionary Objekt, das Standardwerte an die Insert Methode enthält.

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

Im folgenden Beispiel wird das Markup für das vorherige Beispiel gezeigt.

<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" />

Hinweise

Normalerweise müssen Sie die Insert Methode nicht aus Ihrem Code aufrufen. Das datengebundene Steuerelement ruft die Insert Methode automatisch auf, wenn der Benutzer Aktionen zum Einfügen eines neuen Datensatzes ausführt. Sie rufen die Insert Methode explizit auf, wenn Sie ihren eigenen Prozess zum Einfügen von Daten erstellen möchten.