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 のメソッドをオーバーライドする必要があります。状態変更またはメッセージ受信したイベントが発生した場合は、派生クラスが可能な場合は、保護された OnStateChanged と OnMessageReceived のメソッドを呼び出すために必要です。
スレッド セーフ
この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。