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 值将仅用于 PostalCode 字段。 它们不会用于“名称和地址”字段。 即使没有为这些字段输入任何值，也是如此。 如果数据绑定控件为数据源中的所有字段自动生成字段，则不会使用集合中的 InsertParameters 值。