DataRecordsets.AddFromConnectionFile 方法 (Visio)

使用 Office 資料連線 (ODC) 檔案中所包含的連接和查詢資訊，將 DataRecordset 物件新增至 DataRecordsets 集合，以連線到 OLEDB 或 ODBC 資料來源並從中擷取資料。

注意事項

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

語法

運算式。AddFromConnectionFile (FileName、 AddOptions、 Name)

表達 會傳回 DataRecordsets 物件的 運算式。

參數

名稱	必要/選用	資料類型	描述
FileName	必要	字串	要使用的 ODC 連線檔案名稱。
AddOptions	必要	Long	用來決定要新增之資料記錄集屬性的選項。 VisDataRecordsetAddOptions中一或多個列舉值的組合。 如需詳細資訊，請參閱＜備註＞。
名稱	選用	字串	為新增的 DataRecordset 物件指定顯示名稱。

傳回值

DataRecordset

註解

將 ODC 檔案的名稱及完整路徑傳遞給 FileName 參數，此 ODC 檔案中包含連接字串 (用來指定如何連接至 OLEDB 或 ODBC 資料來源) 及查詢字串 (用來指定如何從資料來源中抽選所需的資料)。

ODC 檔案會使用 HTML 及 XML 來儲存連接及查詢資訊。 您可以在任何文字編輯器中檢視或編輯檔案的內容。 ODC 檔案的副檔名是 .odc。 使用 Microsoft Access 或 Microsoft Excel 中的 [資料連線精靈] 來建立 ODC 檔案，以連線並擷取您想要的資料。

AddOptions 參數可以是 VisDataRecordsetAddOptions 列舉中下列一個或多個值的組合，而此列舉會在 Visio 型態程式庫中宣告。 預設值為零 (0)，指定未設定任何選項。

常數	值	描述
visDataRecordsetNoExternalDataUI	1	會防止新資料錄集中的資料顯示在 [外部資料] 視窗中。
visDataRecordsetNoRefreshUI	2	會防止資料記錄集包括在重新整理作業中以及顯示在 [重新整理資料] 對話方塊中。
visDataRecordsetNoAdvConfig	4	會防止資料記錄集顯示在 [設定重新整理] 對話方塊中。
visDataRecordsetDelayQuery	8	加入資料記錄集，但在下次呼叫 Refresh 方法之前，不會執行 CommandString 查詢。
visDataRecordsetDontCopyLinks	16	新增資料記錄集，但不會剪下或複製圖形資料連結。

一旦指定這些值之後，在 DataRecordset 物件存在期間都不能變更。

Name 引數是選擇性字串，可讓您將顯示名稱指派給資料記錄集。 如果您指定 [ 外部資料 ] 視窗顯示在 Visio UI 中，您針對此引數傳遞的名稱會出現在 [ 外部資料 ] 視窗的索引標籤上，該索引標籤會對應至新增的資料記錄集。

如果 AddFromConnectionFile 方法成功，它會執行下列動作：

• 建立 DataRecordset 物件，並將 Name 參數中所指定的名稱指定給它。 如果您未指定名稱，Visio 會將資料來源資料庫資料表的名稱指派給資料記錄集。

• 建立新或現有 DataConnection 物件與 DataRecordset 物件的關聯。

• 執行 ODC 檔案內命令字串中指定的查詢字串，並擷取產生的資料。

• 將資料來源之資料欄的資料類型對應至相等 Visio 資料類型，而篩選結果會移除因沒有相等 Visio 資料類型而無法連結至 Visio 圖形的資料來源資料欄。

• 將資料列識別碼指定給資料記錄集中的每個資料列。 如需資料列識別碼的詳細資訊，請參閱 DataRecordset.GetDataRowIDs 屬性主題。

注意事項

如果發生網路連線錯誤、網路逾時或資料庫權限錯誤，則 AddFromConnectionFile 方法會失敗並傳回例外狀況。

範例

下列 Microsoft Visual Basic for Applications (VBA) 宏會示範如何使用 AddFromConnectionString 方法來連接 Visio 繪圖，以連線到 Microsoft Access 所提供 Northwind 資料庫 Products 資料表中的資料。 執行此範例程式碼之前，請使用 [資料連線精靈] 建立 ODC 檔案，並將 strFile 變數的值取代為您所建立 ODC 檔案的完整路徑和檔案名。 選擇性地為 strName 變數提供不同的值。

Public Sub AddFromConnectionFile_Example() 
 
    Dim strFile As String 
    Dim strName As String 
    Dim vsoDataRecordset As Visio.DataRecordset 
 
    strFile = "C:\Users\username \Documents\My Data Sources\Northwind.mdb Products.odc" 
 
    strName = "Data from ODC" 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets.AddFromConnectionFile(strFile, 0, strName) 
 
End Sub

支援和意見反應

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