LinqDataSource.InsertParameters Propriedade

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 Propriedade

Os parâmetros usados durante uma operação de inserção.

Atributos

BrowsableAttribute PersistenceModeAttribute

Exemplos

O exemplo seguinte mostra um LinqDataSource controlo com um parâmetro que fornece um valor padrão na InsertParameters coleção. Se o utilizador não fornecer um valor para a Category propriedade, o valor padrão fornecido pelo parâmetro é guardado na base de dados.

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

Observações

Normalmente, os valores necessários para uma operação de inserção são passados para o LinqDataSource controlo pelo controlo ligado a dados. Especifica os parâmetros de inserção quando quer fornecer um valor padrão ou define se deve converter valores vazios em null. Não é necessário fornecer um parâmetro para cada valor que será inserido, apenas para os valores que devem ser tratados quando o utilizador não fornece um valor.

Os valores que fornece na InsertParameters coleção são usados apenas para campos definidos na fonte de dados mas que não estão limitados no controlo de dados. Por exemplo, suponha que uma tabela de base de dados tem colunas chamadas Nome, Endereço e Código Postal, mas um ListView controlo vinculado à tabela está limitado apenas aos campos Nome e Endereço. Os valores na InsertParameters coleção serão usados apenas para o campo PostalCode. Não serão usados para o campo Nome e Morada. Isto é verdade mesmo que nenhum valor seja introduzido para esses campos. Se o controlo data-bound gerar automaticamente campos para todos os campos da fonte de dados, nenhum valor da InsertParameters coleção será utilizado.