DataConnectionSupport 類別

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

繼承階層架構

Object
  Microsoft.VisualStudio.Data.Framework.ServiceProvider
    Microsoft.VisualStudio.Data.Framework.DataSiteableServiceProvider<IVsDataConnection>
      Microsoft.VisualStudio.Data.Framework.DataConnectionSupport
        Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetConnectionSupport

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

語法

'宣告
Public MustInherit Class DataConnectionSupport _
    Inherits DataSiteableServiceProvider(Of IVsDataConnection) _
    Implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

public abstract class DataConnectionSupport : DataSiteableServiceProvider<IVsDataConnection>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

public ref class DataConnectionSupport abstract : public DataSiteableServiceProvider<IVsDataConnection^>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit DataSiteableServiceProvider<IVsDataConnection>
        interface IVsDataConnectionSupport 
        interface IServiceProvider 
        interface IDisposable 
        interface IVsDataConnectionEvents 
    end

public abstract class DataConnectionSupport extends DataSiteableServiceProvider<IVsDataConnection> implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

DataConnectionSupport 類型會公開下列成員。

建構函式

	名稱	描述
	DataConnectionSupport	初始化 DataConnectionSupport 類別的新執行個體。

回頁首

屬性

	名稱	描述
	ConnectionString	取得或設定資訊的字串表示需要建立指定資料來源的連接。
	ConnectionTimeout	取得或設定時間，在等待建立連接時在終止嘗試並產生逾時錯誤之前。
	ParentProvider	取得父服務提供者的執行個體。 (繼承自 ServiceProvider)。
	ProviderObject	取得基礎資料提供者，支援目前的資料連接。
	ServiceProvider	取得 Visual Studio 全域服務提供者。
	Site	取得或設定站台。 (繼承自 DataSiteableServiceProvider<T>)。
	State	取得資料連接的狀態。

回頁首

方法

	名稱	描述
	AddService(Type, ServiceCreatorCallback)	加入指定的服務至服務的內部集合。 (繼承自 ServiceProvider)。
	AddService(Type, Object)	加入指定的服務至服務的內部集合。 (繼承自 ServiceProvider)。
	AddService(Type, ServiceCreatorCallback, Boolean)	加入指定的服務至服務的內部集合或父服務容器。 (繼承自 ServiceProvider)。
	AddService(Type, Object, Boolean)	加入指定的服務至服務物件的集合或父服務容器。 (繼承自 ServiceProvider)。
	Close	關閉指定的連接。
	CreateService	建立新的服務物件，指定的服務型別。
	Dispose()	釋放資料連接所持有的所有資源。
	Dispose(Boolean)	釋放資料連接所持有的所有資源。
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	在終結時，釋放資料連接所持有的所有資源資料連接支援物件。 (覆寫 Object.Finalize。)
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetService(Guid)	擷取具有一個項目所指定的服務 GUID 的服務。 (繼承自 ServiceProvider)。
	GetService(Type)	擷取指定之型別的服務。 (繼承自 ServiceProvider)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	Initialize	使用指定的連接，並選擇性地從現有資料提供者物件。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	OnMessageReceived	處理 MessageReceived 事件。
	OnSiteChanged	引發 SiteChanged 事件。 (繼承自 DataSiteableServiceProvider<T>)。
	OnStateChanged	處理 StateChanged 事件。
	Open	開啟指定的資料連接。
	RemoveService(Type)	從內部服務集合移除指定的服務 (繼承自 ServiceProvider)。
	RemoveService(Type, Boolean)	移除指定的服務從內部服務集合或父服務容器。 (繼承自 ServiceProvider)。
	ToString	傳回代表目前物件的字串。 (繼承自 Object)。

回頁首

事件

	名稱	描述
	MessageReceived	發生於訊息時，從資料來源接收。
	SiteChanged	就會發生這個網站已經變更。 (繼承自 DataSiteableServiceProvider<T>)。
	StateChanged	發生於，當資料連接的狀態已變更。

回頁首

明確介面實作

	名稱	描述
	IServiceProvider.QueryService	執行可藉由 IServiceProvider的實作公開服務的 Factory。 (繼承自 ServiceProvider)。

回頁首

備註

DataConnectionSupport 類別表示資料提供者實作支援資料連接。

這個類別的屬性和方法提供允許資料提供者與資料來源通訊的基本功能，實作為左右連接和擷取連接狀態的這類工作。 資料提供者可能會覆寫 CreateService 方法也會公開特定服務。 目前連接相關的服務可以摘要說明如下:

• IVsDataObjectSupport:為描述資料來源和動作所支援的資料物件的型別才能執行的擷取 XML 的方法。

• IVsDataObjectIdentifierResolver:要將資料物件識別碼的方法。

• IVsDataObjectIdentifierConverter:用於轉換的方法給字串和資料物件識別項的陣列表示之間。

• IVsDataObjectMemberComparer:要用來比較資料物件識別項組件和屬性值的方法。

• IVsDataCommand:提供取得和執行命令的各種型別。

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

• IVsDataTransaction:提供開始，且會復原交易。

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

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

• IVsDataMappedObjectConverter:提供資料來源特定中繼資料的自訂對應程式啟用已知的概念供一般設計工具使用。

• IVsDataObjectSelector:取得資料物件的資訊可讓來源特定中繼資料定義在資料物件支援 XML 檔案。

• IDSRefBuilder:提供建立資料來源參考 (DSRef) 物件識別的一或多個資料物件。

這個類別會實作 IVsDataSiteableObject<T> 介面，允許 DDEX 設置資料提供者之 IVsDataConnection 物件的 DataConnectionSupport 實作呼叫它。 這提供實作以內容，以及表示為擷取 Visual Studio 服務。

繼承者注意事項

任何衍生類別都應該實作各種抽象屬性和方法支援其連接。 衍生類別應該覆寫受保護的 CreateService 方法提供其連接服務的實作。 當狀態變更或訊息接收的事件發生時，衍生類別應該，可能的話，，呼叫受保護的 OnStateChanged 和 OnMessageReceived 方法。

執行緒安全

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

請參閱

參考

Microsoft.VisualStudio.Data.Framework 命名空間