次の方法で共有


DataConnection クラス

データ ソースへの接続をサポートします。

継承階層

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