Partager via


LinqDataSource.Insert(IDictionary) Méthode

Définition

Exécute une opération d'insertion.

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

Paramètres

values
IDictionary

Valeurs de ligne à insérer dans la source de données.

Retours

Int32

Nombre de lignes affectées par l'opération d'insertion.

Exemples

L’exemple suivant montre comment insérer par programmation un nouvel enregistrement dans la source de données une fois que l’utilisateur clique sur un bouton. Le code transmet un ListDictionary objet qui contient des valeurs par défaut à la Insert méthode.

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

L’exemple suivant montre le balisage de l’exemple précédent.

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

Remarques

En règle générale, vous n’avez pas besoin d’appeler la Insert méthode à partir de votre code. Le contrôle lié aux données appelle automatiquement la Insert méthode lorsque l’utilisateur prend des mesures pour insérer un nouvel enregistrement. Vous appelez explicitement la Insert méthode lorsque vous souhaitez créer votre propre processus pour insérer des données.

S’applique à