ObjectDataSource.InsertParameters Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh InsertMethod properti .
public:
property System::Web::UI::WebControls::ParameterCollection ^ InsertParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection InsertParameters { get; }[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.InsertParameters : System.Web.UI.WebControls.ParameterCollectionPublic ReadOnly Property InsertParameters As ParameterCollectionNilai Properti
ParameterCollection yang berisi parameter yang digunakan oleh metode yang diidentifikasi oleh InsertMethod properti .
- Atribut
Contoh
Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan ObjectDataSource objek dengan objek bisnis dan DetailsView kontrol untuk menyisipkan data. Contoh kode kedua memberikan contoh implementasi Insert metode yang digunakan dalam contoh kode pertama.
Contoh kode berikut menunjukkan cara menggunakan ObjectDataSource kontrol dengan objek bisnis dan DetailsView kontrol untuk menyisipkan data. Awalnya, DetailsView menampilkan kotak teks tempat Anda bisa memasukkan data untuk rekaman baru NorthwindEmployee , bersama dengan tombol Sisipkan yang dibuat secara otomatis. Setelah Anda memasukkan data ke dalam bidang DetailsView kontrol, klik tombol Sisipkan . Properti InsertMethod mengidentifikasi metode mana yang melakukan operasi penyisipan.
Jika Anda mengklik tombol Sisipkan , operasi dilakukan menggunakan metode yang ditentukan oleh InsertMethod properti dan parameter apa pun yang ditentukan dalam InsertParameters koleksi. Dalam contoh kode ini, satu parameter ditentukan dalam InsertParameters koleksi yang sesuai dengan ID supervisor. Ini karena meskipun ID ditampilkan dalam Rows koleksi untuk DetailsView kontrol sebagai BoundField objek, ID diteruskan sebagai string ke ObjectDataSource kontrol. Dengan menambahkannya secara eksplisit ke InsertParameters koleksi dengan properti yang Type diatur ke Int32 nilai , itu akan diteruskan dengan benar oleh ObjectDataSource ke metode sebagai Int32, bukan sebagai string.
Insert Ketika operasi dilakukan, metode yang diidentifikasi oleh InsertMethod properti dipanggil. Insert Jika metode objek memiliki tanda tangan metode yang menyertakan parameter, InsertParameters koleksi harus berisi parameter yang memiliki nama yang cocok dengan parameter tanda tangan metode agar Insert metode berhasil diselesaikan.
Penting
Anda harus memvalidasi nilai parameter apa pun yang Anda terima dari klien. Runtime hanya mengganti nilai parameter ke InsertMethod dalam properti .
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Import namespace="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:detailsview
id="DetailsView1"
runat="server"
autogenerateinsertbutton="True"
autogeneraterows="false"
datasourceid="ObjectDataSource1"
defaultmode="Insert" >
<fields>
<asp:BoundField headertext="FirstName" datafield="FirstName" />
<asp:BoundField headertext="LastName" datafield="LastName" />
<asp:BoundField headertext="Title" datafield="Title" />
<asp:BoundField headertext="Courtesy" datafield="Courtesy" />
<asp:BoundField headertext="Supervisor" datafield="Supervisor" />
</fields>
</asp:detailsview>
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetEmployee"
insertmethod="InsertNewEmployeeWrapper"
typename="Samples.AspNet.CS.EmployeeLogic" >
<selectparameters>
<asp:parameter name="anID" defaultvalue="-1" />
</selectparameters>
<insertparameters>
<asp:parameter name="Supervisor" type="Int32" />
</insertparameters>
</asp:objectdatasource>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Import namespace="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - VB Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:detailsview
id="DetailsView1"
runat="server"
autogenerateinsertbutton="True"
autogeneraterows="false"
datasourceid="ObjectDataSource1"
defaultmode="Insert" >
<fields>
<asp:BoundField headertext="FirstName" datafield="FirstName" />
<asp:BoundField headertext="LastName" datafield="LastName" />
<asp:BoundField headertext="Title" datafield="Title" />
<asp:BoundField headertext="Courtesy" datafield="Courtesy" />
<asp:BoundField headertext="Supervisor" datafield="Supervisor" />
</fields>
</asp:detailsview>
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetEmployee"
insertmethod="InsertNewEmployeeWrapper"
typename="Samples.AspNet.VB.EmployeeLogic" >
<selectparameters>
<asp:parameter name="anID" defaultvalue="-1" />
</selectparameters>
<insertparameters>
<asp:parameter name="Supervisor" type="Int32" />
</insertparameters>
</asp:objectdatasource>
</form>
</body>
</html>
Contoh kode berikut memberikan contoh implementasi Insert metode yang digunakan contoh kode sebelumnya. Metode InsertNewEmployeeWrapper ini ditambahkan ke EmployeeLogic objek tingkat menengah yang disediakan dalam ObjectDataSource gambaran umum kelas untuk memungkinkan objek bekerja lebih mudah dengan ObjectDataSource kontrol dalam skenario Web, tanpa penulisan ulang yang substansial ke logika bisnis yang sebenarnya.
Untuk menjalankan contoh, Anda harus memiliki NorthwindEmployee kelas yang disediakan dalam ObjectDataSource gambaran umum kelas. Contoh ini hanya menggambarkan cara menyambungkan ObjectDataSource ke metode objek bisnis yang mendapatkan data untuk rekaman database baru dengan menggunakan parameter. Contoh tidak menambahkan rekaman ke database, karena Save metode NorthwindEmployee kelas tidak menyertakan kode untuk memperbarui database.
// This InsertNewEmployeeWrapper method is a wrapper method that enables
// the use of ObjectDataSource and InsertParameters, without
// substantially rewriting the true implementation for the NorthwindEmployee
// or the EmployeeLogic objects.
//
// The parameters to the method must be named the same as the
// DataControlFields used by the GridView or DetailsView controls.
public static void InsertNewEmployeeWrapper (string FirstName,
string LastName,
string Title,
string Courtesy,
int Supervisor)
{
// Build the NorthwindEmployee object and
// call the true implementation.
NorthwindEmployee tempEmployee = new NorthwindEmployee();
tempEmployee.FirstName = FirstName;
tempEmployee.LastName = LastName;
tempEmployee.Title = Title;
tempEmployee.Courtesy = Courtesy;
tempEmployee.Supervisor = Supervisor;
// Call the true implementation.
InsertNewEmployee(tempEmployee);
}
public static void InsertNewEmployee(NorthwindEmployee ne) {
bool retval = ne.Save();
if (! retval) { throw new NorthwindDataException("InsertNewEmployee failed."); }
}
' This InsertNewEmployeeWrapper method is a wrapper method that enables
' the use of ObjectDataSource and InsertParameters, without
' substantially rewriting the true implementation for the NorthwindEmployee
' or the EmployeeLogic objects.
'
' The parameters to the method must be named the same as the
' DataControlFields used by the GridView or DetailsView controls.
Public Shared Sub InsertNewEmployeeWrapper(FirstName As String, LastName As String, Title As String, Courtesy As String, Supervisor As Integer)
' Build the NorthwindEmployee object and
' call the true implementation.
Dim tempEmployee As New NorthwindEmployee()
tempEmployee.FirstName = FirstName
tempEmployee.LastName = LastName
tempEmployee.Title = Title
tempEmployee.Courtesy = Courtesy
tempEmployee.Supervisor = Supervisor
' Call the true implementation.
InsertNewEmployee(tempEmployee)
End Sub
Public Shared Sub InsertNewEmployee(ne As NorthwindEmployee)
Dim retval As Boolean = ne.Save()
If Not retval Then
Throw New NorthwindDataException("InsertNewEmployee failed.")
End If
End Sub
Keterangan
Nama dan jenis parameter yang terkandung dalam InsertParameters koleksi harus cocok dengan nama dan jenis parameter yang ada di InsertMethod tanda tangan properti. Nama parameter peka huruf besar/kecil. Saat bekerja dengan kontrol terikat data yang menyediakan parameter, seperti GridView kontrol dan DetailsView , ObjectDataSource kontrol secara otomatis menggabungkan parameter apa pun yang secara eksplisit ditentukan dalam koleksi dengan parameter yang disediakan oleh kontrol terikat data. Ini penting karena kontrol terikat data selalu menyediakan parameternya sebagai String jenis, dan jika tanda tangan metode menyertakan jenis numerik atau tanggal, Anda harus secara eksplisit menyertakan parameter dalam InsertParameters koleksi dengan jenis yang benar. Jika tidak, ObjectDataSource kontrol mencoba untuk mentransmisikan parameter sesuai dengan jenis yang ditentukan oleh parameter dalam koleksi. Untuk informasi selengkapnya, lihat Menggunakan Parameter dengan ObjectDataSource Control.
Properti InsertParameters mengambil InsertParameters properti yang terkandung oleh ObjectDataSourceView yang terkait dengan ObjectDataSource kontrol.
Untuk informasi selengkapnya tentang penggabungan parameter, masa pakai objek, dan resolusi metode, lihat InsertMethod.
Berlaku untuk
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk