操作說明:將 Windows Forms 控制項繫結至型別
當您在建立與資料互動的控制項時,有時會發現有必要將控制項繫結至類型,而非物件。 特別是在設計階段會發生這種情況,此時資料可能無法使用,但是資料繫結控制項仍然需要顯示類型公用介面中的資訊。 例如,您可能會繫結 DataGridView 控制項至 Web 服務所公開的物件,並想讓 DataGridView 控制項將設計階段的資料行標記為自訂類型的成員名稱。
您可以輕鬆地繫結控制項至具有 BindingSource 元件的類型。
範例
下列程式碼範例示範如何使用 BindingSource 元件將 DataGridView 控制項繫結至自訂類型。 當您執行範例時,您會注意到在控制項填入資料之前,DataGridView 標記會反映 Customer
物件屬性的資料行。 此範例包含 [Add Customer] 按鈕,以將資料加入至 DataGridView 控制項。 當您按一下按鈕,新 Customer
物件會加入至 BindingSource。 在實際案例中,可能會透過呼叫 Web 服務或其他資料來源取得資料。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Windows.Forms;
class Form1 : Form
{
BindingSource bSource = new BindingSource();
private Button button1;
DataGridView dgv = new DataGridView();
public Form1()
{
this.button1 = new System.Windows.Forms.Button();
this.button1.Location = new System.Drawing.Point(140, 326);
this.button1.Name = "button1";
this.button1.AutoSize = true;
this.button1.Text = "Add Customer";
this.button1.Click += new System.EventHandler(this.button1_Click);
this.ClientSize = new System.Drawing.Size(362, 370);
this.Controls.Add(this.button1);
// Bind the BindingSource to the DemoCustomer type.
bSource.DataSource = typeof(DemoCustomer);
// Set up the DataGridView control.
dgv.Dock = DockStyle.Top;
this.Controls.Add(dgv);
// Bind the DataGridView control to the BindingSource.
dgv.DataSource = bSource;
}
public static void Main()
{
Application.Run(new Form1());
}
private void button1_Click(object sender, EventArgs e)
{
bSource.Add(new DemoCustomer(DateTime.Today));
}
}
// This simple class is used to demonstrate binding to a type.
public class DemoCustomer
{
public DemoCustomer()
{
idValue = Guid.NewGuid();
}
public DemoCustomer(DateTime FirstOrderDate)
{
FirstOrder = FirstOrderDate;
idValue = Guid.NewGuid();
}
// These fields hold the data that backs the public properties.
private DateTime firstOrderDateValue;
private Guid idValue;
private string custNameValue;
public string CustomerName
{
get { return custNameValue; }
set { custNameValue = value; }
}
// This is a property that represents a birth date.
public DateTime FirstOrder
{
get
{
return this.firstOrderDateValue;
}
set
{
if (value != this.firstOrderDateValue)
{
this.firstOrderDateValue = value;
}
}
}
// This is a property that represents a customer ID.
public Guid ID
{
get
{
return this.idValue;
}
}
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Windows.Forms
Class Form1
Inherits Form
Private bSource As New BindingSource()
Private WithEvents button1 As Button
Private dgv As New DataGridView()
Public Sub New()
Me.button1 = New System.Windows.Forms.Button()
Me.button1.Location = New System.Drawing.Point(140, 326)
Me.button1.Name = "button1"
Me.button1.AutoSize = True
Me.button1.Text = "Add Customer"
Me.ClientSize = New System.Drawing.Size(362, 370)
Me.Controls.Add(Me.button1)
' Bind the BindingSource to the DemoCustomer type.
bSource.DataSource = GetType(DemoCustomer)
' Set up the DataGridView control.
dgv.Dock = DockStyle.Top
Me.Controls.Add(dgv)
' Bind the DataGridView control to the BindingSource.
dgv.DataSource = bSource
End Sub
Public Shared Sub Main()
Application.Run(New Form1())
End Sub
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles button1.Click
bSource.Add(New DemoCustomer(DateTime.Today))
End Sub
End Class
' This simple class is used to demonstrate binding to a type.
Public Class DemoCustomer
Public Sub New()
idValue = Guid.NewGuid()
End Sub
Public Sub New(ByVal FirstOrderDate As DateTime)
FirstOrder = FirstOrderDate
idValue = Guid.NewGuid()
End Sub
' These fields hold the data that backs the public properties.
Private firstOrderDateValue As DateTime
Private idValue As Guid
Private custNameValue As String
Public Property CustomerName() As String
Get
Return custNameValue
End Get
Set(ByVal value As String)
custNameValue = value
End Set
End Property
' This is a property that represents the first order date.
Public Property FirstOrder() As DateTime
Get
Return Me.firstOrderDateValue
End Get
Set(ByVal value As DateTime)
If value <> Me.firstOrderDateValue Then
Me.firstOrderDateValue = value
End If
End Set
End Property
' This is a property that represents a customer ID.
Public ReadOnly Property ID() As Guid
Get
Return Me.idValue
End Get
End Property
End Class
編譯程式碼
這個範例需要:
- 本系統和 System.Windows.Forms 組件的參考。
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應