LinqDataSource.InsertParameters Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.Extensions.dll

Возвращает коллекцию параметров, которые используются во время операции вставки.

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

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

ParameterCollection

Параметры, которые используются во время операции вставки.

Атрибуты
BrowsableAttribute PersistenceModeAttribute

Примеры

В следующем примере показан LinqDataSource элемент управления с параметром, предоставляющим значение по умолчанию в InsertParameters коллекции. Если пользователь не предоставляет значение для Category свойства, значение по умолчанию, предоставленное параметром, сохраняется в базе данных.

<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 данным. Параметры вставки указываются, если требуется указать значение по умолчанию или определить, следует ли преобразовывать пустые значения в null. Не нужно указывать параметр для каждого вставляемого значения, только для значений, которые должны обрабатываться, если пользователь не предоставляет значение.

Значения, указанные в InsertParameters коллекции, используются только для полей, определенных в источнике данных, но не привязанных к элементу управления данными. Например, предположим, что в таблице базы данных есть столбцы с именами Name, Address и PostalCode, но ListView элемент управления, привязанный к таблице, привязан только к полям "Имя" и "Адрес". Значения в InsertParameters коллекции будут использоваться только для поля "Почтовый индекс". Они не будут использоваться для поля "Имя" и "Адрес". Это верно, даже если для этих полей не введено значение. Если элемент управления с привязкой к данным автоматически создает поля для всех полей в источнике данных, значения из InsertParameters коллекции не будут использоваться.

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