LinqDataSource.InsertParameters 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得插入作業期間所使用的參數集合。

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

屬性值

ParameterCollection

插入作業期間所使用的參數。

屬性

BrowsableAttribute PersistenceModeAttribute

範例

下列範例顯示具有 LinqDataSource 參數的 控制項，其提供集合中的 InsertParameters 預設值。 如果使用者未提供 屬性的值 Category ，參數所提供的預設值會儲存在資料庫中。

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

備註

插入作業所需的值通常會由資料繫結控制項傳遞至 LinqDataSource 控制項。 當您想要提供預設值或定義是否要將空值 null 轉換成 時，您可以指定插入參數。 您不需要為每個要插入的值提供參數，只針對使用者未提供值時必須處理的值。

您在集合中 InsertParameters 提供的值僅適用于資料來源中定義的欄位，但未系結在資料控制項中。 例如，假設資料庫資料表有名為 Name、Address 和 PostalCode 的資料行，但 ListView 系結至資料表的控制項只會系結至 [名稱] 和 [位址] 欄位。 集合中的 InsertParameters 值只會用於 [郵遞區號] 欄位。 它們不會用於 [名稱] 和 [位址] 欄位。 即使未針對這些欄位輸入任何值，也是如此。 如果資料繫結控制項會自動產生資料來源中所有欄位的欄位，則不會使用集合中的 InsertParameters 值。