Visio) (DataRecordset 物件

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

註解

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

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

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

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

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

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

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

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

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

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

使用 Name 屬性將顯示名稱與資料記錄集建立關聯。

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

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

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

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

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

事件

• BeforeDataRecordsetDelete
• DataRecordsetChanged

方法

• Delete
• GetAllRefreshConflicts
• GetDataRowIDs
• GetMatchingRowsForRefreshConflict
• GetPrimaryKey
• GetRowData
• Refresh
• RefreshUsingXML
• RemoveRefreshConflict
• SetPrimaryKey

屬性

• Application
• CommandString
• DataAsXML
• DataColumns
• DataConnection
• Document
• EventList
• ID
• LinkReplaceBehavior
• Name
• ObjectType
• RefreshInterval
• RefreshSettings
• Stat
• TimeRefreshed

支援和意見反應

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