DataConnectionSupport 類別

提供可讓您直接與資料來源的連接時使用的屬性和方法。

繼承階層架構

Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.ServiceProviderWithSite
      Microsoft.VisualStudio.Data.DataConnectionSupport
        Microsoft.VisualStudio.Data.AdoDotNet.AdoDotNetConnectionSupport

命名空間：  Microsoft.VisualStudio.Data
組件：  Microsoft.VisualStudio.Data (在 Microsoft.VisualStudio.Data.dll 中)

語法

'宣告
Public MustInherit Class DataConnectionSupport _
    Inherits ServiceProviderWithSite _
    Implements IDisposable

public abstract class DataConnectionSupport : ServiceProviderWithSite, 
    IDisposable

public ref class DataConnectionSupport abstract : public ServiceProviderWithSite, 
    IDisposable

[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit ServiceProviderWithSite 
        interface IDisposable 
    end

public abstract class DataConnectionSupport extends ServiceProviderWithSite implements IDisposable

DataConnectionSupport 類型會公開下列成員。

建構函式

	名稱	描述
	DataConnectionSupport	類別建構函式。DataConnectionSupport 具現化類別的新執行個體。nonparameterized

回頁首

屬性

	名稱	描述
	ConnectionString	擷取或設定要求的資訊的字串表示建立所指定資料來源的連接。
	ConnectionTimeout	以秒為單位擷取或設定時間，等候，在終止嘗試並產生錯誤逾時之前先建立連接。
	ProviderObject	擷取指定之連接的基礎資料提供者物件。
	ServiceTypes	擷取用於將服務型別清單轉換為 Unmanaged QueryService 方法呼叫之後，服務 GUID 指定，進入 Managed IServiceProvider.GetService 方法呼叫，指定 Managed 型別。 (繼承自 ServiceProvider)。
	Site	擷取或設定站台物件執行個體。 (繼承自 ServiceProviderWithSite)。
	State	擷取資料的連接狀態。

回頁首

方法

	名稱	描述
	Close	關閉指定的連接。
	Dispose()	執行與釋出、釋放或重設資源相關聯的工作。
	Dispose(Boolean)	執行與釋出、釋放或重設資源相關聯的工作。
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	完成連接。 (覆寫 Object.Finalize。)
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetService(Guid)	擷取具有一個項目所指定的服務 GUID 的服務。 (繼承自 ServiceProvider)。
	GetService(Type)	擷取指定之型別的服務。 (繼承自 ServiceProvider)。
	GetServiceImpl(Type)	可讓您取得服務實作。 (覆寫 ServiceProvider.GetServiceImpl(Type)。)
	GetServiceImpl(Guid)	提供擷取服務提供實作以特定的 GUID。 (繼承自 ServiceProvider)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	Initialize	使用指定的連接，並選擇性地從現有的資料提供者物件。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	OnSiteChanged	引發 SiteChanged 事件。 (繼承自 ServiceProviderWithSite)。
	Open	開啟指定的連接。
	RaiseMessageReceived	會在 DataConnection 封入執行個體的 MessageReceived事件。
	RaiseStateChanged	會在 DataConnection 封入執行個體的狀態變更事件。
	ToString	傳回代表目前物件的字串。 (繼承自 Object)。

回頁首

事件

	名稱	描述
	SiteChanged	引發的，則 Site 屬性變更事件。 (繼承自 ServiceProviderWithSite)。

回頁首

明確介面實作

	名稱	描述
	IObjectWithSite.GetSite	擷取 IObjectWithSite.SetSite 使用方法設定的最後一個網站。如果沒有已知的網站，就會擲回例外狀況。 (繼承自 ServiceProviderWithSite)。
	IServiceProvider.QueryService	執行做為傳遞的 IServiceProvider 實作公開服務的 Factory。 (繼承自 ServiceProvider)。
	IObjectWithSite.SetSite	提供網站的 IUnknown 指標的特定物件。 (繼承自 ServiceProviderWithSite)。

回頁首

備註

DataConnectionSupport 類別表示資料提供者實作支援資料連接。 DDEX 結構會呼叫提供者特定 DataConnectionSupport 實作 DataConnection 類別。

屬性和方法在這個類別提供方法讓資料提供者與資料來源通訊的基本功能，執行做為開頭和結尾連接和擷取連接狀態的這類工作。 資料提供者可以透過覆寫方法 GetServiceImpl 也會公開特定服務。 這些連接相關的服務會摘要說明在之後:

• DataViewSupport:提供描述資料來源專用資料檢視 Visual Studio 在伺服器總管中顯示的物件中擷取 XML 的方法。

• DataObjectSupport:提供說明資料物件的型別資料來源和動作的支援才能執行的擷取 XML 的方法。

• DataObjectIdentifierResolver:用來解析資料物件識別項提供一個方法。

• DataObjectIdentifierConverter:提供方法在字串與資料物件識別項的陣列表示之間。

• DataObjectItemComparer:相較於資料物件識別組件和屬性值的方法。

• DataCommand:可讓您取得及執行命令的各種型別。

• DataAsyncCommand:啟用執行資料命令以非同步模式。

• DataTransaction:可讓您啟動，認可，則進行復原交易。

• DataSourceVersionComparer:提供比較兩個資料來源特定版本字串提供一個方法。

• DataSourceInformation:提供描述資料來源之一組妥善定義的名稱/值組。

這個類別會實作介面， IObjectWithSite 允許 DDEX 設置資料提供者的和 DataConnection 物件的 DataConnectionSupport 實作呼叫它。 這個實作提供內容，以及使用方法以擷取 Visual Studio 服務。

任何衍生類別都應該實作各種抽象屬性和方法支援它們的連接。 衍生類別應該覆寫受保護的方法 GetServiceImpl提供其連接服務。 當狀態變更或接收訊息的事件發生時，衍生類別應該，可能的話，呼叫受保護的 RaiseStateChanged 和 RaiseMessageReceived 方法，然後基底類別傳遞至站台 DataConnection 物件。

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Data 命名空間

ServiceProviderWithSite

IDisposable