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	サービスの GUID がマネージ型が指定されるマネージ IServiceProvider.GetService のメソッド呼び出しに、指定されたアンマネージの QueryService のメソッド呼び出しの変換に使用されるサービスの種類の一覧を取得します。 (ServiceProvider から継承されます。)
	Source	現在のデータ接続のデータ ソースのグローバル一意識別子 (GUID) があれば取得します。
	SourceInformation	一連のデータ ソースの特性を記述する既知の名前と値のペアを提供するオブジェクトを取得します。
	SourceVersionComparer	データ ソース固有のバージョン番号を比較できるオブジェクトを取得します。
	State	このデータ接続の現在の状態を取得します。
	Transaction	トランザクション処理を有効にするオブジェクトを取得します; つまり、およびデータ ソースのロールバックのトランザクションが開始されるように、コミットするようにします。
	ViewSupport	現在のデータ接続でサポートされているさまざまなデータのビューを定義する XML ストリームを提供するオブジェクトを取得します。

このページのトップへ

メソッド

	名前	説明
	Clone	元のと同じ接続プロパティ、および状態を保持します。このデータ接続の複製されたインスタンスを作成します。
	Close	現在のデータ接続を閉じます。
	Dispose()	現在のデータ接続と関連付けられたリソースをすべて破棄します。
	Dispose(Boolean)	DDEX インフラストラクチャをサポートします。コードから直接使用するためのものではありません。
	Equals	指定のオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (Object から継承されます。)
	EquivalentTo	現在の接続に関する情報が指定した接続情報と、デザイン時の意味で、等しいかどうかを示すブール値を取得します。
	Finalize	接続を終了します。 (Object.Finalize() をオーバーライドします。)
	GetExclusiveAccessProxy	呼び出し元にデータ接続への排他アクセスを許可するプロキシ インスタンスを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。 (Object から継承されます。)
	GetLockedProviderObject()	現在のデータ接続をサポートする基になるデータ プロバイダーのオブジェクトがあれば取得します。
	GetLockedProviderObject(Int32)	現在のデータ接続をサポートする基になるデータ プロバイダーのオブジェクトがあれば取得します。
	GetService(Guid)	指定したサービスの GUID でサービスを取得します。 (ServiceProvider から継承されます。)
	GetService(Type)	指定した型のサービスを取得します。 (ServiceProvider から継承されます。)
	GetServiceImpl(Guid)	特定の GUID をサービスを取得するために実装を提供します。 (ServiceProvider から継承されます。)
	GetServiceImpl(Type)	特定の型のサービスを取得する実装を提供します。 (ServiceProvider から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnMessageReceived	MessageReceived のイベントのハンドラー。
	OnStateChanged	StateChanged のイベントのハンドラー。
	Open	このデータ接続を開きます。
	ReleaseExclusiveAccessProxy	GetExclusiveAccessProxy のメソッドを呼び出して、既存の排他アクセスのプロキシを、そのまま解放します。
	ToString	現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)
	UnlockProviderObject	GetLockedProviderObject のメソッドの呼び出しを使用してロックされた DDEX プロバイダー オブジェクトのロックを解除します。

このページのトップへ

イベント

	名前	説明
	MessageReceived	メッセージがデータ ソースから受け取ったときに発生するイベント。
	StateChanged	データ接続の状態が変更されたときに発生するイベント。

このページのトップへ

明示的インターフェイスの実装

	名前	説明
	ICloneable.Clone	現在のインスタンスのコピーである新しい接続オブジェクトのインスタンスを作成します。
	IServiceProvider.QueryService	IServiceProvider の実装によって公開されるサービスのファクトリとして実行します。 (ServiceProvider から継承されます。)

このページのトップへ

解説

このクラスは、データ ソースの基本的な通信を提供し、開始と終了の接続などの機能をサポートしています。また、データ ソースに対して特定の機能を公開する一連のサービスへのアクセスを提供します。

DDEX は、このクラスの一つの実装を提供します; データ プロバイダーは DataConnection のクラスの独自の実装を提供する必要があります。代わりに、DDEX プロバイダーは DataConnection のインスタンスでラップされた DataConnectionSupportのクラスを実装する必要があります。

この方法の利点は、DDEX がクライアントとデータ プロバイダーの両方に主要機能を提供するようにすることです: 複数のクライアントが同じ接続を共有しますが生じた場合に競合を作成できるように接続をロックします。このアーキテクチャによって、クライアントは互いに競合を気にする必要はなく、データ プロバイダーは、マルチスレッド アクセスを気にする必要はありません。

DataConnection のクラスは DataConnectionSupportクラスのインスタンスのプロキシ オブジェクトとして機能することによって、接続の既知の DDEX サービスを使用できるようにプロキシ オブジェクトを提供することによって、このロックのレベルを実現します。これらのプロキシは、その接続のロックを解除するデータ プロバイダーの実装を呼び出す接続のロックによって、各メソッドおよびプロパティを実装します。

スレッド セーフ

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

参照

関連項目

Microsoft.VisualStudio.Data 名前空間

ICloneable

IDisposable