DataGrid.DataMember 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 atau mengatur daftar tertentu di DataSource mana DataGrid kontrol menampilkan kisi.
public:
property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };
public string DataMember { get; set; }
member this.DataMember : string with get, set
Public Property DataMember As String
Nilai Properti
Daftar dalam DataSource. Defaultnya adalah string kosong ("").
Contoh
Contoh kode berikut mengatur DataSource properti System.Windows.Forms.DataGrid dan DataMember kontrol.
protected:
Object^ source;
private:
void SetSourceAndMember()
{
DataSet^ myDataSet = gcnew DataSet( "myDataSet" );
DataTable^ tableCustomers = gcnew DataTable( "Customers" );
myDataSet->Tables->Add( tableCustomers );
// Insert code to populate the DataSet.
// Set DataSource and DataMember with SetDataBinding method.
String^ member;
// The name of a DataTable is Customers.
member = "Customers";
dataGrid1->SetDataBinding( myDataSet, member );
}
protected object source;
private void SetSourceAndMember(){
DataSet myDataSet = new DataSet("myDataSet");
DataTable tableCustomers = new DataTable("Customers");
myDataSet.Tables.Add(tableCustomers);
// Insert code to populate the DataSet.
// Set DataSource and DataMember with SetDataBinding method.
string member;
// The name of a DataTable is Customers.
member = "Customers";
dataGrid1.SetDataBinding(myDataSet, member);
}
Private Sub SetSourceAndMember()
Dim myDataSet As DataSet = New DataSet("myDataSet")
Dim customersTable As DataTable = new DataTable("Customers")
' Insert code to set source to populate DataSet.
' Set DataSource and DataMember with SetDataBinding method.
Dim member As String
' The name of a DataTable is Customers.
member = "Customers"
DataGrid1.SetDataBinding(myDataSet, member)
End Sub
Keterangan
Jika berisi DataSource beberapa sumber data, Anda harus mengatur ke DataMember salah satu sumber. Misalnya, jika DataSource adalah DataSet atau DataViewManager yang berisi tiga tabel bernama Customers, , Ordersdan OrderDetails, Anda harus menentukan salah satu tabel yang akan diikat.
DataSet Jika atau DataViewManager hanya berisi satu DataTable, Anda harus mengatur DataMember ke TableName yang DataTable.
DataSource Jika diatur ke yang DataSet berisi DataRelation objek, tabel induk akan muncul dengan tanda plus (+) di setiap header baris. Mengklik tanda plus menyebabkan simpul muncul yang berisi tautan ke tabel anak. Misalnya, jika berisi DataSet dua DataTable objek bernama Customers dan Orders, mengatur DataMember ke Customers tabel menyebabkan System.Windows.Forms.DataGrid menampilkan tabel induk dengan tanda plus terlihat pada setiap header baris.
DataMember Namun, jika diatur ke Orders, header baris akan kosong.
DataSource Jika adalah DataTable, , DataViewkoleksi, atau array, mengatur DataMember properti akan melemparkan pengecualian.
Nota
Pada waktu proses, Anda harus menggunakan SetDataBinding metode untuk mengatur ulang DataSource properti. Namun, DataMember properti saja dapat direset kapan saja ke nama tabel yang valid.