LinqDataSource.InsertParameters Свойство

Определение

Возвращает коллекцию параметров, которые используются во время операции вставки.Gets the collection of parameters that are used during an insert operation.

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; }
member this.InsertParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property InsertParameters As ParameterCollection

Значение свойства

Параметры, которые используются во время операции вставки.The parameters that are used during an insert operation.

Атрибуты

Примеры

В следующем примере показан элемент управления LinqDataSource с параметром, предоставляющим значение по умолчанию в коллекции InsertParameters.The following example shows a LinqDataSource control with a parameter that provides a default value in the InsertParameters collection. Если пользователь не предоставляет значение для свойства Category, значение по умолчанию, предоставляемое параметром, сохраняется в базе данных.If the user does not provide a value for the Category property, the default value that is provided by the parameter is saved in the database.

<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 элементом управления с привязкой к данным.Typically the values that are needed for an insert operation are passed to the LinqDataSource control by the data-bound control. Параметры INSERT указываются, если необходимо указать значение по умолчанию или преобразовать пустые значения в null.You specify insert parameters when you want to provide a default value or define whether to convert empty values to null. Нет необходимости предоставлять параметр для каждого значения, которое будет вставлено, только для значений, которые должны быть обработаны, если пользователь не предоставил значение.You do not have to provide a parameter for every value that will be inserted, only for the values that must be handled when the user does not provide a value.

Значения, предоставленные в коллекции InsertParameters, используются только для полей, определенных в источнике данных, но не привязанных к элементу управления данными.The values that you provide in the InsertParameters collection are used only for fields that are defined in the data source but that are not bound in the data control. Например, предположим, что таблица базы данных содержит столбцы с именами Name, Address и PostalCode, но элемент управления ListView, привязанный к таблице, привязан только к полям имя и адрес.For example, suppose a database table has columns that are named Name, Address, and PostalCode, but a ListView control that is bound to the table is bound only to the Name and Address fields. Значения в коллекции InsertParameters будут использоваться только для поля PostalCode.The values in the InsertParameters collection will be used only for the PostalCode field. Они не будут использоваться для поля "имя" и "адрес".They will not be used for the Name and Address field. Это справедливо, даже если для этих полей не задано значение.This is true even if no value is entered for those fields. Если элемент управления с привязкой к данным автоматически создает поля для всех полей в источнике данных, то значения из коллекции InsertParameters не будут использоваться.If the data-bound control autogenerates fields for all fields in the data source, no values from the InsertParameters collection will be used.

Применяется к