次の方法で共有


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 の簡易コピーを作成します。 (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の実装によって公開されるサービスのファクトリとして実行します。 (ServiceProvider から継承されます。)

このページのトップへ

解説

DataConnectionSupport のクラスは、データ接続をサポートするデータ プロバイダーの実装を表します。

このクラスのプロパティとメソッドは、データ プロバイダーは、データ ソースと通信できるようにする開始と終了の接続と接続の状態を取得できます。このようなタスクを実行する基本機能を提供します。データ プロバイダーは、CreateService のメソッドをオーバーライドする、特殊なサービスを公開できます。現在の接続に関連するサービスは次のようにまとめることができます:

  • IVsDataObjectSupport: その上で実行できる操作とデータ ソースでサポートされているデータ オブジェクトの型を記述する XML を取得するためのメソッドを提供します。

  • IVsDataObjectIdentifierResolver: データ オブジェクトの識別子を解決するためのメソッドを提供します。

  • IVsDataObjectIdentifierConverter: データのオブジェクト ID 文字列と配列のビューの間の変換のメソッドを提供します。

  • IVsDataObjectMemberComparer: データ オブジェクトの識別子の一部とプロパティ値を比較するメソッドを提供します。

  • IVsDataCommand: コマンドのさまざまな型を派生して実装する機能を提供します。

  • IVsDataAsyncCommand: 非同期のデータ コマンドを実行できるようにします。

  • IVsDataTransaction: まず、コミットする機能を提供するトランザクションをロールバックします。

  • IVsDataSourceVersionComparer: 2 種類のデータ ソースの特定のバージョン文字列を比較するメソッドを提供します。

  • IVsDataSourceInformation: データ ソースを定義する一連にまとめられている名前と値のペアを提供します。

  • IVsDataMappedObjectConverter: 一般的なデザイナーでの使用に既知の概念にデータ ソースの特定のメタデータのカスタマイズされたマッパーを提供する Enables。

  • IVsDataObjectSelector: データは、データ オブジェクトのサポートの XML ファイルで定義されているオブジェクトに関するソース固有のメタデータを取得 Enables。

  • IDSRefBuilder: 一つ以上のデータ オブジェクトを識別するデータ ソースの参照の (DSRef) のオブジェクトを作成できます。

このクラスは DDEX が、呼び出し元の IVsDataConnection のオブジェクトとデータ プロバイダーの DataConnectionSupport の実装が配置されるようにする IVsDataSiteableObject<T> のインターフェイスを実装します。これはコンテキストを実装、および Visual Studio のサービスを取得する手段できます。

継承時の注意

どの派生クラスで接続をサポートするためにさまざまに抽象プロパティとメソッドを実装する必要があります。派生クラスは、接続サービスの実装を提供するために、プロテクト CreateService のメソッドをオーバーライドする必要があります。状態変更またはメッセージ受信したイベントが発生した場合は、派生クラスが可能な場合は、保護された OnStateChangedOnMessageReceived のメソッドを呼び出すために必要です。

スレッド セーフ

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

参照

関連項目

Microsoft.VisualStudio.Data.Framework 名前空間