LinqDataSource.InsertParameters Eigenschaft

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

Eigenschaftswert

Die Parameter, die während eines Einfügevorgangs verwendet werden.

Attribute

BrowsableAttribute PersistenceModeAttribute

Beispiele

Das folgende Beispiel zeigt ein LinqDataSource Steuerelement mit einem Parameter, der einen Standardwert in der InsertParameters Auflistung bereitstellt. Wenn der Benutzer keinen Wert für die Category Eigenschaft bereitstellt, wird der standardwert, der vom Parameter bereitgestellt wird, in der Datenbank gespeichert.

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

Hinweise

In der Regel werden die Werte, die für einen Einfügevorgang erforderlich sind, vom datengebundenen Steuerelement an das LinqDataSource Steuerelement übergeben. Sie geben Einfügeparameter an, wenn Sie einen Standardwert angeben oder definieren, ob leere Werte nullin konvertiert werden sollen. Sie müssen keinen Parameter für jeden eingefügten Wert angeben, nur für die Werte, die behandelt werden müssen, wenn der Benutzer keinen Wert bereitstellt.

Die Werte, die Sie in der InsertParameters Auflistung angeben, werden nur für Felder verwendet, die in der Datenquelle definiert sind, aber nicht im Datensteuerelement gebunden sind. Angenommen, eine Datenbanktabelle enthält Spalten mit dem Namen "Name", "Adresse" und "Postleitzahl", aber ein ListView Steuerelement, das an die Tabelle gebunden ist, ist nur an die Felder "Name" und "Adresse" gebunden. Die Werte in der InsertParameters Auflistung werden nur für das Feld "Postleitzahl" verwendet. Sie werden nicht für das Feld "Name" und "Adresse" verwendet. Dies gilt auch dann, wenn für diese Felder kein Wert eingegeben wird. Wenn das datengebundene Steuerelement Felder für alle Felder in der Datenquelle automatisch generiert, werden keine Werte aus der InsertParameters Auflistung verwendet.