ObjectReferenceTracker クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
変数および接続をパッケージから削除することの影響および結果に関する分析を提供します。 このクラスは継承できません。
public ref class ObjectReferenceTracker sealed : Microsoft::SqlServer::Dts::Runtime::DtsObjectpublic sealed class ObjectReferenceTracker : Microsoft.SqlServer.Dts.Runtime.DtsObjecttype ObjectReferenceTracker = class
inherit DtsObjectPublic NotInheritable Class ObjectReferenceTracker
Inherits DtsObject- 継承
注釈
ObjectReferenceTracker は、影響分析を表示するためのメカニズムです。 コンポーネントで使用しているオブジェクト、およびそのオブジェクトの格納場所を登録します。 他のユーザーまたはコンポーネントがそのオブジェクトを削除しようとすると、システムから情報が表示され、この情報によって、オブジェクトが別の場所で使用されていないことを確認できます。オブジェクトが他の場所で使用されている場合、システムからその情報が表示されます。 コンポーネントまたはパッケージからの変数に対する参照を追加または削除する場合、変数の参照一覧を更新する必要があります。
現在参照トラッカーがサポートしているオブジェクトの種類の一覧は、DTSObjectReferenceType 列挙に表示されます。
変数またはコレクションを使用するランタイム タスクやパイプライン コンポーネントは、AddReference メソッドを使用してオブジェクトの参照リストを作成します。 また SetListInfo を呼び出して、一覧の使用場所と説明を指定する必要があります。 たとえば、1 つの変数を使用するタスクは、変数の名前を場所情報として使用し、変数の使用目的に関する説明を用途説明として使用します。
変数または接続をさまざまな目的で使用するタスクやコンポーネントは、必要に応じて個別の参照一覧を作成できます。 たとえば、条件分割コンポーネントは出力時に変数を式で使用します。この場合、変数を使用する出力式ごとに参照一覧を作成できます。 使用場所としてコンポーネント名を設定し、式および式が存在する場所を説明に追加します。 同じ変数を複数の式で使用する場合、システムによってそれぞれの使用場所が追跡されます。
読み取り専用変数および読み取り/書き込み変数に対し、別々の DTSObjectReferenceType 列挙が用意されています。 VariableDispenser クラスによる変数ロックとこの仕様を併用することにより、デッドロックの問題の解決に役立つ情報が提供されます。
メソッド
| AddReference(String, DTSObjectReferenceType, Int32) |
このメソッドは、参照追跡一覧に参照を追加します。 |
| DestroyList(Int32) |
このメソッドは、指定した参照一覧を参照追跡から破棄します。 |
| Equals(Object) |
2 つのオブジェクト インスタンスが等しいかどうかを判断します。 (継承元 DtsObject) |
| GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 DtsObject) |
| RemoveReference(String, DTSObjectReferenceType, Int32) |
既存の一覧から参照を削除します。 |
| SetListInfo(Int32, String, String) |
このメソッドを使用すると、既存の参照一覧にメタデータを指定できます。 |