如何：擷取使用現有的連線資料連接

發行項
05/16/2015

若要擷取的 DDEX IVsDataConnection物件執行個體為其那里現有的連線資料、用戶端必須擷取連線資料，並將它傳遞給適當的方法。連線資料是由 DDEX 提供者，指定的 GUID 及連線字串所組成。有三種情況下您都能取得連線使用現有的連線資料：

擷取新的或現有的連線，藉由使用IVsDataConnectionManager DDEX 用戶端所提供的連線資料與服務。
藉由擷取與現有的連線資料的新連線IVsDataConnectionFactory服務。
擷取包裝現有的非 DDEX 提供者物件，以使用所提供的資料連接IVsDataConnectionFactory服務。

在其中建立新連線時正在使用使用者輸入的情況下，請參閱如何：擷取連接，根據使用者輸入。

案例一

一個分析藍本牽涉到使用中擷取現有的連接物件IVsDataConnectionManager以及適當的連線資料。萬一其中目前受管理的連線，連線管理員會傳回新的連線。如果相反地，連線管理員目前管理就等於指定的連接物件，它會傳回這個連接物件。

若要開啟現有的連線，藉由使用 DataConnectionManager 服務

呼叫 IVsDataConnectionManager 類別中的 GetConnection 方法。
傳入的 DDEX 提供者 (Guid)，連接字串 (String)，和布林值，指出是否已加密的連接字串。

如果這或相同連線目前正管理，這會傳回指定的連接物件。此外，它會傳回新的連線物件，以指定的連接的資料。

案例二

在兩個案例中，新的連線同時建立並使用擷取IVsDataConnectionFactory，一次提供適當的 DDEX 提供者 guid、連接字串和一個分析藍本所述的布林值參數。

若要開啟 [新連線]，請使用 DataConnectionFactory 服務

呼叫CreateConnection的IVsDataConnectionFactory類別。
傳入的 DDEX 提供者 (Guid)，連接字串 (String)，和布林值，指出是否已加密的連接字串。

這回到可用的隔離的連線物件只會建立它的用戶端。

案例三

在三個案例中，使用非 DDEX 連線物件的用戶端想要存取之連接的 DDEX 功能。例如，DDEX 實作有使用標準的 SQL 連線ADO.NET SQL 的連線物件，但卻想要使用特定的 DDEX 功能。若要這樣做，就必須建立 DDEX 連線使用基礎提供者物件 (ADO.NET，在此情況下) 並使用包含在 DDEX 連線MakeConnectionFrom方法。

若要使用 DataConnectionFactory 服務來包裝現有的提供者物件

建立基礎的非 DDEX 提供者物件。
呼叫 IVsDataConnectionFactory 類別中的 MakeConnectionFrom 方法。
傳入的非 DDEX 提供者物件執行個體 (Object) 和提供者的 guid。

這會建立 DDEX 連接物件包裝基礎提供者物件。

注意事項

呼叫Dispose上此資料連線的方法不會終結基礎的非 DDEX 提供者物件。

重要

您選擇要包裝基礎的連接物件的 DDEX 提供者必須能夠了解它所包裝的物件。這使得選取重要的 DDEX 提供者物件。