LinqDataSource.InsertParameters Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Auflistung der während eines Einfügevorgangs verwendeten Parameter ab.

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

ParameterCollection

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

Attribute: BrowsableAttribute PersistenceModeAttribute

Beispiele

Im folgenden Beispiel wird ein Steuerelement mit einem LinqDataSource Parameter angezeigt, der einen Standardwert in der InsertParameters Auflistung bereitstellt. Wenn der Benutzer keinen Wert für die Eigenschaft bereitstellt, wird der Standardwert, der vom Parameter bereitgestellt wird, in der Category 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ügenvorgang benötigt werden, an das Steuerelement durch das LinqDataSource datengebundene Steuerelement übergeben. Sie geben Einfügeparameter an, wenn Sie einen Standardwert angeben oder definieren möchten, ob leere Werte in nullkonvertiert werden sollen. Sie müssen keinen Parameter für jeden Wert angeben, der eingefügt wird, nur für die Werte, die behandelt werden müssen, wenn der Benutzer keinen Wert bereitstellt.

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

Gilt für