共用方式為

DataAdapter、DataTable 與 DataColumn 對應

  • 發行項

適用於：.NET Framework .NET .NET Standard

下載 ADO.NET

SqlDataAdapter 在 TableMappings 屬性中包含零個或以上 DataTableMapping 物件的集合。 DataTableMapping 提供查詢資料來源所傳回的資料與 DataTable 之間的主要對應。 您可傳遞 DataTableMapping 名稱，將 DataTable 名稱取代為 DataAdapter 的 Fill 方法。 下列範例為 Authors 資料表建立名為 AuthorsMapping 的 DataTableMapping。

workAdapter.TableMappings.Add("AuthorsMapping", "Authors");

DataTableMapping 可讓您在 DataTable 中使用與資料庫中不同的資料行名稱。 資料表更新後，DataAdapter 便使用對應來比對資料行。

注意

若未指定 TableName 或 DataTableMapping 名稱就呼叫 DataAdapter 的 Fill 或 Update 方法，DataAdapter 會尋找名為 "Table" 的 DataTableMapping。 如果 DataTableMapping 不存在，則 DataTable 的 TableName 為 "Table"。 您可以建立名為 "Table" 的 DataTableMapping 來指定預設 DataTableMapping。

下列程式碼範例從 System.Data.Common 命名空間建立 DataTableMapping，並將其命名為 "Table"，使其成為所指定 DataAdapter 的預設對應。 接著，範例將查詢結果中第一個資料表的資料行 (Northwind 資料庫的 Customers 資料表) 對應至 DataSet 中 Northwind Customers 資料表內一組更方便使用的名稱。 未被對應的資料行會使用來自資料來源的資料行名稱。

// Assumes that connection is a valid SqlConnection object.
DataSet custDataSet = new DataSet();

SqlDataAdapter custAdapter = new SqlDataAdapter(
    "SELECT * FROM dbo.Customers", connection);

DataTableMapping mapping =
    custAdapter.TableMappings.Add("Table", "NorthwindCustomers");
mapping.ColumnMappings.Add("CompanyName", "Company");
mapping.ColumnMappings.Add("ContactName", "Contact");
mapping.ColumnMappings.Add("PostalCode", "ZIPCode");

custAdapter.Fill(custDataSet);

在更為進階的情況中，您可能決定要以同一個 DataAdapter 載入具有不同對應的不同資料表。 您只要另外加上 DataTableMapping 物件即可完成這項作業。

當您將 DataSet 的執行個體和 DataTableMapping 名稱傳遞給 Fill 方法時，除非使用具有該名稱的對應，否則便會使用具有這個名稱的 DataTable。

下列範例使用 Customers 名稱建立 DataTableMapping，並以 BizTalkSchema 名稱建立 DataTable。 接著，此範例會將 SELECT 陳述式傳回的資料列對應至 BizTalkSchemaDataTable。

// Assumes that connection is a valid SqlConnection object.
DataSet custDataSet = new DataSet();

SqlDataAdapter custAdapter = new SqlDataAdapter(
    "SELECT * FROM dbo.Customers", connection);

// The DataTableMapping is implemented ITableMapping.
ITableMapping mapping =
    custAdapter.TableMappings.Add("Table", "BizTalkSchema");
mapping.ColumnMappings.Add("CustomerID", "ClientID");
mapping.ColumnMappings.Add("CompanyName", "ClientName");
mapping.ColumnMappings.Add("ContactName", "Contact");
mapping.ColumnMappings.Add("PostalCode", "ZIP");

custAdapter.Fill(custDataSet);

注意

如果未提供資料行對應的來源資料行名稱，則會自動產生預設名稱。 如果不為資料行對應提供來源資料行，則資料行對應會被指定 SourceColumnN 的遞增預設名稱，並從 SourceColumn1 開始。

注意

如果未提供資料表對應的來源資料表名稱，則會自動產生預設名稱。 如果不為資料表對應提供來源資料表，則資料表對應會被指定 SourceTableN 的遞增預設名稱，並從 SourceTable1 開始。

注意

資料行對應建議避免使用 SourceColumnN 的命名慣例，或資料表對應避免 SourceTableN 的命名慣例，因為您提供的名稱，可能會與 ColumnMappingCollection 中的現有預設資料行對應名稱，或 DataTableMappingCollection 中的資料表對應名稱發生衝突。 如果提供的名稱已經存在，便會擲回例外狀況。

處理多個結果集

如果您的 SelectCommand 傳回多份資料表，Fill 會自動為 DataSet 中的資料表產生遞增值資料表名稱，從指定的資料表名稱開始，以 TableName1 開始的 TableNameN 格式繼續。 您可以使用資料表對應，將自動產生的資料表名稱對應至您要指定給 DataSet 內資料表的名稱。 例如，如果是針對傳回兩個資料表 Customers 與 OrdersSelectCommand，請對 Fill 發出下列呼叫。

adapter.Fill(customersDataSet, "Customers");

這兩個資料表建立於 DataSet 中：Customers 和 Customers1。 您可以使用資料對應來確保第二個資料表名為 Orders，而不是 Customers1。 若要執行這項作業，請將來源資料表 Customers1 對應至 DataSet 資料表 Orders，如下列範例所示。

// Assumes that connection is a valid SqlConnection object.
string queryString =
"SELECT * FROM dbo.Customers; SELECT * FROM dbo.Orders;";
SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection);

DataSet customersDataSet = new DataSet();

adapter.TableMappings.Add("Customers1", "Orders");
adapter.Fill(customersDataSet, "Customers");

請參閱