Практическое руководство. Связывание элемента управления с типом в Windows Forms
При создании элементов управления, взаимодействующих с данными, иногда бывает нужно привязать элемент управления к типу, а не к объекту. Такая ситуация особенно часто возникает на этапе разработки, когда данные недоступны, но все равно нужно, чтобы элемент управления отображал данные из открытого интерфейса типа. Например, вы привязываете элемент управления DataGridView к объекту, предоставляемому веб-службой, и хотите, чтобы во время разработки элемент управления DataGridView помечал свои столбцы именами членов пользовательского типа.
Элемент управления можно легко привязать к типу с помощью компонента BindingSource.
Пример
В примере кода ниже показано, как привязать элемент управления DataGridView к пользовательскому типу с помощью компонента BindingSource. После запуска примера можно увидеть, что DataGridView пометил столбцы, отражающие свойства объекта Customer
, перед заполнением элемента управления данными. В примере есть кнопка Add Customer (Добавить клиента) для добавления данных в элемент управления DataGridView. При нажатии на кнопку новый объект Customer
добавляется в BindingSource. В реальном сценарии данные можно было бы получить путем вызова веб-службы или другого источника данных.
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 и System.Windows.Forms;
См. также
.NET Desktop feedback
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по