共用方式為

Visio (的 DataRecordset 物件)

  • 發行項

會在 Microsoft Visio 中儲存、格式化、重新整理和公開從資料庫查詢而來的資料。

注意事項

This Visio object or member is available only to licensed users of Visio Professional 2013.

註解

Microsoft Visio 可以連接至各種來源的資料，包括下列：

  • Excel 工作表
  • Access 資料庫
  • SQL Server 資料庫
  • SharePoint 清單
  • 其他 OLEDB/ODBC 資料來源，例如 Oracle 資料庫
  • 遵守 ADO 傳統 XML 架構的 XML 檔案

每個 Visio Document 物件都有一個 DataRecordsets 集合，在連線到資料來源之前，該集合是空的。 若要將 Visio 文件連接至資料來源，您可以將 DataRecordset 物件新增至文件的 DataRecordsets 集合。

若要將 DataRecordset 物件新增至 DataRecordsets 集合，您可以使用下列三種方法之一，視您想要連線到 (OLEDB/ODBC 或 XML) 的資料來源類型，以及如何將連接字串和查詢命令字串傳遞至 Visio 而定。 使用：

  • DataRecordsets.Add 方法，您可以連線到 OLEDB 或 ODBC 資料來源，並將連線和查詢命令字串資訊直接當作方法參數傳遞至 Visio。

  • DataRecordsets.AddFromConnectionFile 方法，您可以將 Office 資料連線 (ODC) 檔案傳遞給方法，以連線到 OLEBD 或 ODBC 資料來源，其中包含您要提供給 Visio 的連接和查詢命令字串資訊。

  • DataRecordsets.AddFromXML 方法，您會將 ADO 傳統 XML 字串傳遞給 方法，其中包含您想要包含在記錄集中的所有資料。

建立資料記錄集之後，與記錄集相關聯的連接字串和查詢命令字串分別由 DataConnection.ConnectionString 和 CommandString 屬性工作表示。

如果資料記錄集與DataConnection物件相關聯，也就是說，如果您使用Add或AddFromConnectionFile方法將其新增至DataRecordsets集合，您可以使用DataConnection屬性來取得相關聯的 DataConnection物件。

DataRecordset物件的預設屬性是ID。 ID 屬性值會識別 DataRecordsets 集合中的 DataRecordset，並且在任何特定文件的集合中都是唯一的。

使用 Name 屬性將顯示名稱與記錄集產生關聯。

使用 GetDataRowIDs 方法可取得記錄集中所有資料列的識別碼陣列，其中每個資料列都代表單一資料記錄。 以這種方式擷取資料列識別碼之後，您可以使用 GetRowData 方法來取得資料列中每個資料行中儲存的所有資料。

使用 DataColumns 屬性來取得與記錄集相關聯的 DataColumn 物件。 DataColumn 物件展示的方法與屬性，可用來自訂資料欄對應至儲存格，這些儲存格在連結至資料的圖形之 Visio ShapeSheet 試算表的「圖形資料」區段中。

設定資料錄集的主索引鍵可協助在重新整理資料時防止圖形與資料之間的連結中斷。 使用 GetPrimaryKey 與 SetPrimaryKey 方法可分別取得和設定主索引鍵資料欄。

當資料來源中的資料變更時，可以重新整理連接的 (非 XML) 資料錄集內的資料，以反映那些變更。 透過設定 RefreshInterval 屬性，可以指定 Visio 在指定週期自動重新整理資料；或者透過呼叫 Refresh 方法，可以程式設計方式來重新整理資料。

當重新整理的資料是來自上次重新整理資料之後已變更的資料來源時，可能會發生衝突。 當單一圖形連結至相同資料來源中的多個資料列，或圖形連結至資料來源中已刪除的資料列時，可能會產生衝突。 您可以藉由使用 GetAllRefreshConflicts、GetMatchingRowsForRefreshConflict 及 RemoveRefreshConflict 方法，來尋找並解決因重新整理資料而發生的衝突。

注意事項

在儲存含有一個或多個資料記錄集的 Visio 文件時，會在 Visio 中儲存記錄集內的所有資料。 對於含有大量資料的記錄集，可以建立大型 Visio 檔案，這會影響其效能。 因此，您應該考慮在將資料匯入 Visio 之前先篩選大型資料來源。

事件

方法

屬性

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。