LinqDataSource.InsertParameters Propiedad

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

Valor de propiedad

Parámetros que se usan durante una operación de inserción.

Atributos

BrowsableAttribute PersistenceModeAttribute

Ejemplos

En el ejemplo siguiente se muestra un LinqDataSource control con un parámetro que proporciona un valor predeterminado en la InsertParameters colección. Si el usuario no proporciona un valor para la Category propiedad , el valor predeterminado proporcionado por el parámetro se guarda en la base de datos.

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

Comentarios

Normalmente, los valores necesarios para una operación de inserción se pasan al control mediante el control enlazado a LinqDataSource datos. Especifique los parámetros de inserción cuando quiera proporcionar un valor predeterminado o defina si se van a convertir valores vacíos en null. No es necesario proporcionar un parámetro para cada valor que se insertará, solo para los valores que se deben controlar cuando el usuario no proporcione un valor.

Los valores que proporcione en la InsertParameters colección solo se usan para los campos definidos en el origen de datos, pero que no están enlazados en el control de datos. Por ejemplo, supongamos que una tabla de base de datos tiene columnas denominadas Nombre, Dirección y Código Postal, pero un ListView control enlazado a la tabla solo está enlazado a los campos Nombre y Dirección. Los valores de la InsertParameters colección solo se usarán para el campo PostalCode. No se usarán para el campo Nombre y Dirección. Esto es true incluso si no se especifica ningún valor para esos campos. Si el control enlazado a datos genera automáticamente campos para todos los campos del origen de datos, no se usará ningún valor de la InsertParameters colección.