Visual Studio 中的对象绑定

项目
08/18/2008

更新：2007 年 11 月

Visual Studio 提供设计时工具，可在应用程序中将自定义对象（相对于数据集和 Web 服务）作为数据源使用。

自定义对象与 Visual Studio 中的数据设计工具一起使用的唯一要求是，该对象需要至少一个公共属性。自定义对象与诸如“数据源”窗口的工具一起使用时，不需要特定的构造函数或属性。

将对象用作数据源时，虽然有无数种方法可实现应用程序逻辑，但是，通过使用由 Visual Studio 生成的新的 TableAdapter 对象，只能简化很少的一部分标准操作。本页解释如何使用 TableAdapter 实现这些标准操作；而不应用作创建自定义对象的指南。例如，在不考虑对象的特定实现或应用程序逻辑的情况下，您通常执行以下标准操作：

将数据加载到对象（通常来自数据库）中
创建对象的类型化集合
在集合中添加和移除对象
在窗体中向用户显示对象数据
更改/编辑对象中的数据
将对象中的数据保存回数据库

说明：
为更好地理解本页上的示例并为其提供上下文，建议您完成以下演练：演练：连接到对象中的数据。该演练将创建本“帮助”页所讨论的对象。

将数据加载到对象中

在此示例中，将使用 TableAdapter 将数据加载到对象中。默认情况下，创建 TableAdapter 并使用它的以下两种方法来分别用于获取数据库中的数据和填充数据表。

TableAdapter.Fill 方法使用返回的数据填充现有的数据表。
TableAdapter.GetData 方法返回已填充数据的新数据表。

将数据加载到自定义对象的最简单的方法是调用 TableAdapter.GetData 方法，循环访问返回的数据表的行集合，并用各行中的值填充各个对象。可以创建 GetData 方法，该方法可为添加到 TableAdapter 中的任何查询均返回已填充的数据表。

说明：
默认情况下，Visual Studio 将 TableAdapter 查询命名为 Fill 和 GetData，但这些名称可以更改为任何有效的方法名称。

下面的示例演示如何循环访问数据表中的行，并用数据填充对象：

有关完整的代码示例，请参见演练：连接到对象中的数据。

Private Sub LoadCustomers()
    Dim customerData As NorthwindDataSet.CustomersDataTable = _
        CustomersTableAdapter1.GetTop5Customers()

    Dim customerRow As NorthwindDataSet.CustomersRow

    For Each customerRow In customerData
        Dim currentCustomer As New Customer()
        With currentCustomer

            .CustomerID = customerRow.CustomerID
            .CompanyName = customerRow.CompanyName

            If Not customerRow.IsAddressNull Then
                .Address = customerRow.Address
            End If

            If Not customerRow.IsCityNull Then
                .City = customerRow.City
            End If

            If Not customerRow.IsContactNameNull Then
                .ContactName = customerRow.ContactName
            End If

            If Not customerRow.IsContactTitleNull Then
                .ContactTitle = customerRow.ContactTitle
            End If

            If Not customerRow.IsCountryNull Then
                .Country = customerRow.Country
            End If

            If Not customerRow.IsFaxNull Then
                .Fax = customerRow.Fax
            End If

            If Not customerRow.IsPhoneNull Then
                .Phone = customerRow.Phone
            End If

            If Not customerRow.IsPostalCodeNull Then
                .PostalCode = customerRow.PostalCode
            End If

            If Not customerRow.Is_RegionNull Then
                .Region = customerRow._Region
            End If

        End With

        LoadOrders(currentCustomer)
        CustomerBindingSource.Add(currentCustomer)
    Next
End Sub

private void LoadCustomers()
{
    NorthwindDataSet.CustomersDataTable customerData = 
        customersTableAdapter1.GetTop5Customers();

    foreach (NorthwindDataSet.CustomersRow customerRow in customerData)
    {
        Customer currentCustomer = new Customer();
        currentCustomer.CustomerID = customerRow.CustomerID;
        currentCustomer.CompanyName = customerRow.CompanyName;

        if (customerRow.IsAddressNull() == false)
        {
            currentCustomer.Address = customerRow.Address;
        }

        if (customerRow.IsCityNull() == false)
        {
            currentCustomer.City = customerRow.City;
        }

        if (customerRow.IsContactNameNull() == false)
        {
            currentCustomer.ContactName = customerRow.ContactName;
        }

        if (customerRow.IsContactTitleNull() == false)
        {
            currentCustomer.ContactTitle = customerRow.ContactTitle;
        }

        if (customerRow.IsCountryNull() == false)
        {
            currentCustomer.Country = customerRow.Country;
        }

        if (customerRow.IsFaxNull() == false)
        {
            currentCustomer.Fax = customerRow.Fax;
        }

        if (customerRow.IsPhoneNull() == false)
        {
            currentCustomer.Phone = customerRow.Phone;
        }

        if (customerRow.IsPostalCodeNull() == false)
        {
            currentCustomer.PostalCode = customerRow.PostalCode;
        }

        if (customerRow.IsRegionNull() == false)
        {
            currentCustomer.Region = customerRow.Region;
        }

        LoadOrders(currentCustomer);
        customerBindingSource.Add(currentCustomer);
    }
}

创建对象的类型化集合

您可以为对象创建集合类，或使用由 BindingSource 组件自动提供的类型化集合。

为对象创建自定义集合类时，建议从 BindingList<T> 继承。此泛型类提供管理集合的功能，此外，它还能引发事件，这些事件可向 Windows 窗体中的数据绑定基础结构发送通知。

BindingSource 中自动生成的集合对其类型化集合使用 BindingList<T>。如果应用程序不要求其他功能，则可以在 BindingSource 中维护集合。有关更多信息，请参见 BindingSource 类的 List 属性。

说明：
如果 BindingList<T> 的基实现提供不了集合要求的功能，则您应创建自定义集合，以便在需要时将其添加到类中。

下面的代码演示如何为 Order 对象的强类型集合创建类：

''' <summary>
''' A collection of Orders
''' </summary>
Public Class Orders
    Inherits System.ComponentModel.BindingList(Of Order)

    ' Add any additional functionality required by your collection.

End Class

/// <summary>
/// A collection of Orders
/// </summary>
public class Orders: System.ComponentModel.BindingList<Order>
{
    // Add any additional functionality required by your collection.
}

向集合中添加对象

通过调用自定义集合类或 BindingSource 的 Add 方法，可将对象添加到集合中。

有关使用 BindingSource 向集合添加对象的示例，请参见演练：连接到对象中的数据中的 LoadCustomers 方法。

有关将向自定义集合添加对象的示例，请参见演练：连接到对象中的数据中的 LoadOrders 方法。

说明：
从 BindingList<T> 继承时，将自动为您的自定义集合提供 Add 方法。

下面的代码演示如何向 BindingSource 中的类型化集合添加对象：

Dim currentCustomer As New Customer()
CustomerBindingSource.Add(currentCustomer)

Customer currentCustomer = new Customer();
customerBindingSource.Add(currentCustomer);

下面的代码演示如何向从 BindingList<T> 继承的类型化集合添加对象：

说明：
在此示例中，Orders 集合是 Customer 对象的属性。

Dim currentOrder As New Order()
currentCustomer.Orders.Add(currentOrder)

Order currentOrder = new Order();
currentCustomer.Orders.Add(currentOrder);

将对象从集合中移除

通过调用自定义集合类或 BindingSource 的 Remove 或 RemoveAt 方法，可将对象从集合中移除。

说明：
从 BindingList<T> 继承时，将自动为您的自定义集合提供 Remove 和 RemoveAt 方法。

下面的代码演示如何使用 RemoveAt 方法，从 BindingSource 中的类型化集合中定位并移除对象：

Dim customerIndex As Integer = CustomerBindingSource.Find("CustomerID", "ALFKI")
CustomerBindingSource.RemoveAt(customerIndex)

int customerIndex = customerBindingSource.Find("CustomerID", "ALFKI");
customerBindingSource.RemoveAt(customerIndex);

向用户显示对象数据

若要向用户显示对象中的数据，请使用数据源配置向导创建对象数据源，然后从“数据源”窗口将整个对象或单个属性拖动到窗体上。

有关创建对象数据源的更多信息，请参见如何：连接到对象中的数据。

有关在 Windows 窗体上显示对象数据的更多信息，请参见在 Windows 应用程序中的窗体上显示数据。

修改对象中的数据

若要编辑数据绑定到 Windows 窗体控件的自定义对象中的数据，只需编辑绑定控件中的数据（或直接在对象属性中编辑）即可。数据绑定结构将更新对象中的数据。

如果应用程序要求跟踪更改并将建议的更改回滚为其原始值，则必须在对象模型中实现此功能。有关数据表如何跟踪建议的更改的示例，请参见 DataRowState、HasChanges 和 GetChanges。

将对象中的数据保存回数据库

通过将对象中的值传递到 TableAdapter 的 DBDirect 方法，可将数据保存回数据库。

Visual Studio 创建的 DBDirect 方法可直接对数据库执行操作。这些方法不需要 DataSet 或 DataTable 对象。

TableAdapter DBDirect 方法	说明
TableAdapter.Insert	向数据库中添加新记录，此方法允许将值作为方法参数传入各个列。
TableAdapter.Update	更新数据库中的现有记录。Update 方法将原始列值和新列值用作方法参数。原始值用于定位原始记录，新值用于更新该记录。通过将 DataSet、DataTable、DataRow、或 DataRow 数组用作方法参数，TableAdapter.Update 方法还可用于将数据集中的更改协调回数据库。
TableAdapter.Delete	基于作为方法参数传入的原始列值，删除数据库的现有记录。

TableAdapter.Insert

向数据库中添加新记录，此方法允许将值作为方法参数传入各个列。

TableAdapter.Update

更新数据库中的现有记录。Update 方法将原始列值和新列值用作方法参数。原始值用于定位原始记录，新值用于更新该记录。

通过将 DataSet、DataTable、DataRow、或 DataRow 数组用作方法参数，TableAdapter.Update 方法还可用于将数据集中的更改协调回数据库。

TableAdapter.Delete

基于作为方法参数传入的原始列值，删除数据库的现有记录。

若要保存对象集合中的数据，请循环访问该对象集合（例如，使用 for-next 循环），然后使用 TableAdapter 的 DBDirect 方法将每个对象的值发送到数据库中。

下面的示例演示如何使用 TableAdapter.Insert DBDirect 方法将新客户直接添加到数据库中：

Private Sub AddNewCustomer(ByVal currentCustomer As Customer)

    CustomersTableAdapter.Insert( _
        currentCustomer.CustomerID, _
        currentCustomer.CompanyName, _
        currentCustomer.ContactName, _
        currentCustomer.ContactTitle, _
        currentCustomer.Address, _
        currentCustomer.City, _
        currentCustomer.Region, _
        currentCustomer.PostalCode, _
        currentCustomer.Country, _
        currentCustomer.Phone, _
        currentCustomer.Fax)
End Sub

private void AddNewCustomers(Customer currentCustomer)
{
    customersTableAdapter.Insert( 
        currentCustomer.CustomerID, 
        currentCustomer.CompanyName, 
        currentCustomer.ContactName, 
        currentCustomer.ContactTitle, 
        currentCustomer.Address, 
        currentCustomer.City, 
        currentCustomer.Region, 
        currentCustomer.PostalCode, 
        currentCustomer.Country, 
        currentCustomer.Phone, 
        currentCustomer.Fax);
}

请参见

任务

如何：连接到对象中的数据

演练：连接到对象中的数据

如何：将数据从对象保存到数据库

如何：使用 TableAdapter 直接访问数据库

演练：用 TableAdapter DBDirect 方法保存数据

其他资源

在 Windows 应用程序中的窗体上显示数据

TableAdapter

保存数据