DataConnectionSupport 類別

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

繼承階層架構

System.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 命名空間