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に電話して使用場所とリストの説明も提供する必要があります。 例えば、単一の変数を持つタスクは、その名前を位置情報として、変数が何に使われるかの説明を使用説明として使います。
変数や接続の異なる用途を持つタスクやコンポーネントは、必要なだけ多くの個別の参照リストを作成することがあります。 例えば、条件分割コンポーネントは出力の表現式に変数を使い、変数を使う各出力式ごとに別々の参照リストを作成できます。 コンポーネント名を使用場所として設定し、記述に式とその所在を含めます。 同じ変数が複数の式で使われている場合、各使用場所はシステムによって追跡されます。
読み取り専用変数と読み取り/書き込み変数には別々の列挙 DTSObjectReferenceType があります。 この仕様と変数ロックを組み合わせて、 VariableDispenser クラスと組み合わせることで、デッドロック問題の解決に役立つ情報を提供できます。
メソッド
| 名前 | 説明 |
|---|---|
| AddReference(String, DTSObjectReferenceType, Int32) |
この方法は、参照トラッキングのためにリストへの参照を追加します。 |
| DestroyList(Int32) |
この方法は、指定された参照リストをリファレンストラッキングから破壊します。 |
| Equals(Object) |
2 つのオブジェクト インスタンスが等しいかどうかを判断します。 (継承元 DtsObject) |
| GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 DtsObject) |
| RemoveReference(String, DTSObjectReferenceType, Int32) |
既存のリストから参照を削除します。 |
| SetListInfo(Int32, String, String) |
この方法により、既存の参考文献リストのメタデータを提供できます。 |