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 値は、PostalCode フィールドにのみ使用されます。 [名前] フィールドと [アドレス] フィールドには使用されません。 これは、これらのフィールドに値が入力されていない場合でも当てはまります。 データ バインド コントロールがデータ ソース内のすべてのフィールドのフィールドを自動生成する場合、コレクションの InsertParameters 値は使用されません。