一个DataAdapter包含零个或多集合xref:System.Data.Common.DataTableMapping中的对象及其TableMappings属性。 一个DataTableMapping提供了从对数据源,查询返回的数据之间的主映射和xref:System.Data.DataTable。 DataTableMapping可以将名称传递来代替DataTable到名称填充方法DataAdapter。 下面的示例创建DataTableMapping名为AuthorsMapping有关作者表。
workAdapter.TableMappings.Add("AuthorsMapping", "Authors")
workAdapter.TableMappings.Add("AuthorsMapping", "Authors");
一个DataTableMapping使您能够使用中的列名DataTable从数据库中的不同。 DataAdapter使用此映射来更新表时的列匹配。
如果未指定TableName或DataTableMapping时调用的名称填充或者更新方法DataAdapter,则DataAdapter寻找DataTableMapping名为"Table"。 如果该DataTableMapping不存在TableName的DataTable为"Table"。 可以指定默认值DataTableMapping通过创建DataTableMapping "Table"的名称。
下面的代码示例将创建DataTableMapping (从xref:System.Data.Common命名空间),并使其指定的默认映射DataAdapter通过其命名为"Table"。 该示例然后将映射从查询结果中的第一个表的列 (客户表的Northwind数据库) 到一组更为用户友好名称中Northwind 客户表中xref:System.Data.DataSet。 对于未映射的列,将使用数据源中的列名称。
Dim mapping As DataTableMapping = _
adapter.TableMappings.Add("Table", "NorthwindCustomers")
mapping.ColumnMappings.Add("CompanyName", "Company")
mapping.ColumnMappings.Add("ContactName", "Contact")
mapping.ColumnMappings.Add("PostalCode", "ZIPCode")
adapter.Fill(custDS)
DataTableMapping mapping =
adapter.TableMappings.Add("Table", "NorthwindCustomers");
mapping.ColumnMappings.Add("CompanyName", "Company");
mapping.ColumnMappings.Add("ContactName", "Contact");
mapping.ColumnMappings.Add("PostalCode", "ZIPCode");
adapter.Fill(custDS);
在更高级的情况下,你可能决定想相同DataAdapter以支持不同的映射不同的表加载。 若要执行此操作,只需添加附加DataTableMapping对象。
当填充方法传递的一个实例数据集和一个DataTableMapping名称,如果具有该名称的映射存在,则为; 否则为DataTable这使用名称。
以下示例创建两个DataTableMapping一个名为客户和一个DataTable的名称BizTalkSchema。 该示例然后将映射到 SELECT 语句返回的行BizTalkSchema DataTable。
Dim mapping As ITableMapping = _
adapter.TableMappings.Add("Customers", "BizTalkSchema")
mapping.ColumnMappings.Add("CustomerID", "ClientID")
mapping.ColumnMappings.Add("CompanyName", "ClientName")
mapping.ColumnMappings.Add("ContactName", "Contact")
mapping.ColumnMappings.Add("PostalCode", "ZIP")
adapter.Fill(custDS, "Customers")
ITableMapping mapping =
adapter.TableMappings.Add("Customers", "BizTalkSchema");
mapping.ColumnMappings.Add("CustomerID", "ClientID");
mapping.ColumnMappings.Add("CompanyName", "ClientName");
mapping.ColumnMappings.Add("ContactName", "Contact");
mapping.ColumnMappings.Add("PostalCode", "ZIP");
adapter.Fill(custDS, "Customers");
Note: 如果没有为列映射提供源列名称或者没有为表映射提供源表名称,则将自动生成默认名称。 如果为列映射提供没有源列,则列映射提供递增的默认名称的SourceColumn N开头SourceColumn1。 如果为表映射提供没有源表名称,则表映射提供递增的默认名称的SourceTable N,从开始SourceTable1。
Note: 我们建议你避免的命名约定SourceColumn N为列映射,或SourceTable N表映射,因为所提供的名称可能与中现有默认列映射名称冲突ColumnMappingCollection或表中的映射名称DataTableMappingCollection. 如果提供的名称已经存在,将引发异常。
处理多个结果集
如果你SelectCommand返回多个表填充自动生成具有递增的值中的表的表名称数据集,从开始在窗体上指定表名和继续TableName N,从开始TableName1。 可以使用表映射自动生成的表名称映射到要为表中指定的名称数据集。 例如,对于SelectCommand ,它返回两个表客户并订单,发出以下调用到填充。
adapter.Fill(customersDataSet, "Customers")
在中创建两个表数据集:客户并Customers1。 可以使用表映射以确保第二个表名为订单而不是Customers1。 若要执行此操作,将映射的源表Customers1到数据集表订单,如以下示例所示。
adapter.TableMappings.Add("Customers1", "Orders")
adapter.Fill(customersDataSet, "Customers")
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
