Compartilhar via


LinqDataSource.InsertParameters Propriedade

Definição

Obtém a coleção de parâmetros usados durante uma operação de inserção.

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

ParameterCollection

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

Atributos

Exemplos

O exemplo a seguir mostra um LinqDataSource controle com um parâmetro que fornece um valor padrão na InsertParameters coleção. Se o usuário não fornecer um valor para a Category propriedade, o valor padrão fornecido pelo parâmetro será salvo no banco 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>

Comentários

Normalmente, os valores necessários para uma operação de inserção são passados para o LinqDataSource controle pelo controle associado a dados. Especifique os parâmetros de inserção quando quiser fornecer um valor padrão ou defina se deseja converter valores vazios em null. Você não precisa fornecer um parâmetro para cada valor que será inserido, somente para os valores que devem ser tratados quando o usuário não fornecer um valor.

Os valores que você fornece na InsertParameters coleção são usados apenas para campos definidos na fonte de dados, mas que não estão associados ao controle de dados. Por exemplo, suponha que uma tabela de banco de dados tenha colunas denominadas Nome, Endereço e PostalCode, mas um ListView controle associado à tabela está associado somente aos campos Nome e Endereço. Os valores na InsertParameters coleção serão usados apenas para o campo PostalCode. Eles não serão usados para o campo Nome e Endereço. Isso é verdadeiro mesmo que nenhum valor seja inserido para esses campos. Se o controle associado a dados gerar automaticamente campos para todos os campos na fonte de dados, nenhum valor da InsertParameters coleção será usado.

Aplica-se a