LinqDataSource.InsertParameters Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Extensions.dll

Obtiene la colección de parámetros que se usan durante una operación de inserción.

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

ParameterCollection

Parámetros que se utilizan 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 LinqDataSource control enlazado a 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 las columnas que se denominan nombre, dirección y código postal, pero un ListView está enlazado el control que está enlazado a la tabla sólo a los campos de 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 los campos de control enlazado a datos genera automáticamente para todos los campos en los datos de origen, no hay valores de la InsertParameters se usará la colección.