DataConnection 類別

支援與資料來源的連接。

繼承階層架構

System.Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.DataConnection

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

語法

'宣告
Public MustInherit Class DataConnection _
    Inherits ServiceProvider _
    Implements ICloneable, IDisposable

public abstract class DataConnection : ServiceProvider, 
    ICloneable, IDisposable

public ref class DataConnection abstract : public ServiceProvider, 
    ICloneable, IDisposable

[<AbstractClass>]
type DataConnection =  
    class
        inherit ServiceProvider
        interface ICloneable
        interface IDisposable
    end

public abstract class DataConnection extends ServiceProvider implements ICloneable, IDisposable

DataConnection 型別會公開下列成員。

建構函式

	名稱	說明
	DataConnection	類別建構函式。具現化 DataConnection 類別的新執行個體。

回頁首

屬性

	名稱	說明
	AsyncCommand	擷取一個可以執行命令的衍生和非同步執行資料來源中的物件。
	Command	擷取一個可以執行命令的衍生和執行資料來源中的物件。
	ConnectionSupport	擷取用來支援目前資料的介面執行個體的基礎資料提供者連接支援物件。
	ConnectionTimeout	在命令會開啟連接逾時之前擷取或設定時間，以秒為單位)。
	DisplayConnectionString	以 DDEX 提供者特定字串的形式，擷取或設定未加密的連接資訊。
	EncryptedConnectionString	使用 DPAPI 加密，提供者特定字串的形式，擷取或設定加密的連接資訊。
	IsLockedForExclusiveAccess	擷取表示目前連接布林值以獨佔存取的用戶端鎖定。
	ObjectChangeEvents	提供擷取時引發的事件集的物件，在資料來源中的資料物件加入，以變更或移除時。
	ObjectIdentifierConverter	擷取可從格式化字串的資料物件識別項至未格式化的組件 (反之亦然) 的物件。
	ObjectIdentifierResolver	擷取可以展開或壓縮剖析資料物件識別項的物件。
	ObjectItemComparer	擷取可以比較識別組件和屬性在資料物件中的物件。
	ObjectSupport	提供擷取定義各種 DDEX 資料物件型別的 XML 資料流支援目前資料連接的物件。
	Provider	擷取 DDEX 提供者的唯一識別項目前資料連接的。
	ProviderObjectIsLocked	擷取表示基礎提供者物件 DDEX 布林值鎖定供用戶端使用。
	ServiceTypes	擷取用於將服務型別清單轉換為 Unmanaged QueryService 方法呼叫之後，服務 GUID 指定，進入 Managed IServiceProvider.GetService 方法呼叫，指定 Managed 型別。 (繼承自 ServiceProvider)。
	Source	擷取資料來源的全域唯一識別項 (Locale Identifier (GUID) 目前資料連接的，，如果有的話。
	SourceInformation	提供擷取描述資料來源之特性的一組已知的名稱/值組的物件。
	SourceVersionComparer	擷取可讓您比較特定資料來源的版本號碼的物件。
	State	擷取這個資料連接的目前狀態。
	Transaction	擷取啟用交易處理的物件;也可讓您啟動，且在資料來源中復原交易。
	ViewSupport	提供擷取定義各種資料檢視的 XML 資料流支援目前資料連接的物件。

回頁首

方法

	名稱	說明
	Clone	建立這個資料連接已複製的執行個體，保持連接屬性和狀態與原始相同。
	Close	關閉目前的資料連接。
	Dispose()	管理目前資料連接及其關聯的所有資源。
	Dispose(Boolean)	支援 DDEX 基礎結構並不適合直接從程式碼使用。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	EquivalentTo	擷取表示與目前連接資訊的布林值是相等的，在設計階段的觀點而言，使用指定的連接資訊。
	Finalize	完成連接。 (覆寫 Object.Finalize()。)
	GetExclusiveAccessProxy	擷取允許呼叫端將資料連接的獨佔存取的 Proxy 執行個體。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetLockedProviderObject()	如果有的話，擷取基礎資料提供者物件支援目前的資料連接。
	GetLockedProviderObject(Int32)	如果有的話，擷取基礎資料提供者物件支援目前的資料連接。
	GetService(Guid)	擷取具有一個項目所指定的服務 GUID 的服務。 (繼承自 ServiceProvider)。
	GetService(Type)	擷取指定之型別的服務。 (繼承自 ServiceProvider)。
	GetServiceImpl(Guid)	提供擷取服務提供實作以特定的 GUID。 (繼承自 ServiceProvider)。
	GetServiceImpl(Type)	提供擷取特定型別之服務的實作。 (繼承自 ServiceProvider)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	OnMessageReceived	MessageReceived 事件的處理常式。
	OnStateChanged	StateChanged 事件的處理常式。
	Open	開啟這個資料連接。
	ReleaseExclusiveAccessProxy	釋放現有的獨佔存取權， Proxy 所提供的呼叫將 GetExclusiveAccessProxy 方法。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。
	UnlockProviderObject	開啟用來 GetLockedProviderObject，方法的呼叫已鎖定的 DDEX 提供者物件。

回頁首

事件

	名稱	說明
	MessageReceived	引發事件，當訊息從資料來源接收。
	StateChanged	引發事件，當資料連接的狀態已變更。

回頁首

明確介面實作

	名稱	說明
	ICloneable.Clone	建立目前執行個體複本的新連接物件執行個體。
	IServiceProvider.QueryService	執行做為傳遞的 IServiceProvider 實作公開服務的 Factory。 (繼承自 ServiceProvider)。

回頁首

備註

這個類別會提供基本通訊資料來源，則支援這個功能 (例如開啟和關閉連接。它也提供存取公開更特定的功能與資料來源中的一組服務。

DDEX 提供這個類別的唯一實作;資料提供者不應提供這些 DataConnection 類別的實作。相反地， DDEX 提供者應該實作 DataConnectionSupport類別，由 DataConnection 執行個體會包裝。

這個方法的優點是它可讓 DDEX 提供的一項重要功能給用戶端和資料提供者:鎖定的連結，讓多個用戶端可以共用相同的連接，還是不會產生衝突。這個結構中，用戶端就不需要擔心彼此衝突，然後，資料提供者不需要擔心多執行緒的存取。

DataConnection 類別達到鎖定的這個層級會透過 Proxy 物件當做 DataConnectionSupport類別執行個體，以及透過提供 Proxy 物件為每一個已知 DDEX 服務可從連接。這些 Proxy 透過鎖定介面實作每個方法和屬性，然後呼叫資料提供者的實作，然後開啟連接。

執行緒安全

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

請參閱

參考

Microsoft.VisualStudio.Data 命名空間

ICloneable

IDisposable