Partager via


LinqDataSource.InsertParameters Propriété

Définition

Obtient la collection de paramètres utilisés lors d'une opération d'insertion.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ InsertParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection InsertParameters { get; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.InsertParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property InsertParameters As ParameterCollection

Valeur de propriété

ParameterCollection

Paramètres utilisés lors d'une opération d'insertion.

Attributs

Exemples

L’exemple suivant montre un LinqDataSource contrôle avec un paramètre qui fournit une valeur par défaut dans la InsertParameters collection. Si l’utilisateur ne fournit pas de valeur pour la Category propriété, la valeur par défaut fournie par le paramètre est enregistrée dans la base de données.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    ID="LinqDataSource1" 
    runat="server">
    <UpdateParameters>
      <asp:Parameter Name="Category" DefaultValue="Miscellaneous" />
    </UpdateParameters>
    <InsertParameters>
      <asp:Parameter Name="Category" DefaultValue="Miscellaneous" />
    </InsertParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    ID="LinqDataSource1" 
    runat="server">
    <UpdateParameters>
      <asp:Parameter Name="Category" DefaultValue="Miscellaneous" />
    </UpdateParameters>
    <InsertParameters>
      <asp:Parameter Name="Category" DefaultValue="Miscellaneous" />
    </InsertParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Remarques

En règle générale, les valeurs nécessaires pour une opération d’insertion sont transmises au contrôle par le contrôle lié aux LinqDataSource données. Vous spécifiez des paramètres d’insertion lorsque vous souhaitez fournir une valeur par défaut ou définir s’il faut convertir des valeurs vides nullen . Vous n’avez pas besoin de fournir un paramètre pour chaque valeur qui sera insérée, uniquement pour les valeurs qui doivent être gérées lorsque l’utilisateur ne fournit pas de valeur.

Les valeurs que vous fournissez dans la InsertParameters collection sont utilisées uniquement pour les champs définis dans la source de données, mais qui ne sont pas liés dans le contrôle de données. Par exemple, supposons qu’une table de base de données comporte des colonnes nommées Nom, Adresse et PostalCode, mais qu’un ListView contrôle lié à la table est lié uniquement aux champs Nom et Adresse. Les valeurs de la InsertParameters collection seront utilisées uniquement pour le champ PostalCode. Ils ne seront pas utilisés pour le champ Nom et Adresse. Cela est vrai même si aucune valeur n’est entrée pour ces champs. Si le contrôle lié aux données génère automatiquement des champs pour tous les champs de la source de données, aucune valeur de la InsertParameters collection n’est utilisée.

S’applique à