LinqDataSource.InsertParameters Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Extensions.dll

Mendapatkan kumpulan parameter yang digunakan selama operasi penyisipan.

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

Nilai Properti

ParameterCollection

Parameter yang digunakan selama operasi penyisipan.

Atribut

BrowsableAttribute PersistenceModeAttribute

Contoh

Contoh berikut menunjukkan LinqDataSource kontrol dengan parameter yang menyediakan nilai default dalam InsertParameters koleksi. Jika pengguna tidak memberikan nilai untuk Category properti , nilai default yang disediakan oleh parameter disimpan dalam 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>

Keterangan

Biasanya nilai yang diperlukan untuk operasi penyisipan diteruskan ke LinqDataSource kontrol oleh kontrol terikat data. Anda menentukan sisipkan parameter saat Anda ingin memberikan nilai default atau menentukan apakah akan mengonversi nilai kosong ke null. Anda tidak perlu memberikan parameter untuk setiap nilai yang akan disisipkan, hanya untuk nilai yang harus ditangani ketika pengguna tidak memberikan nilai.

Nilai yang Anda berikan dalam InsertParameters koleksi hanya digunakan untuk bidang yang ditentukan dalam sumber data tetapi tidak terikat dalam kontrol data. Misalnya, tabel database memiliki kolom bernama Nama, Alamat, dan Kode Pos, tetapi ListView kontrol yang terikat ke tabel hanya terikat ke bidang Nama dan Alamat. Nilai dalam InsertParameters koleksi hanya akan digunakan untuk bidang PostalCode. Mereka tidak akan digunakan untuk bidang Nama dan Alamat. Ini berlaku bahkan jika tidak ada nilai yang dimasukkan untuk bidang tersebut. Jika kontrol terikat data menghasilkan bidang secara otomatis untuk semua bidang di sumber data, tidak ada nilai dari koleksi yang InsertParameters akan digunakan.