Freigeben über


ObjectReferenceTracker Klasse

Definition

Stellt Analysen an, wie sich das Löschen von Variablen und Verbindungen aus einem Paket auswirkt. Diese Klasse kann nicht vererbt werden.

public ref class ObjectReferenceTracker sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject
public sealed class ObjectReferenceTracker : Microsoft.SqlServer.Dts.Runtime.DtsObject
type ObjectReferenceTracker = class
    inherit DtsObject
Public NotInheritable Class ObjectReferenceTracker
Inherits DtsObject
Vererbung
ObjectReferenceTracker

Hinweise

Dies ObjectReferenceTracker ist ein Mechanismus zum Anzeigen der Auswirkungenanalyse. Sie registrieren die Objekte, die Ihre Komponenten verwenden und wo sie gefunden werden. Wenn ein anderer Benutzer oder eine andere Komponente versucht, ein Objekt zu löschen, kann das System Informationen bereitstellen, mit denen Sie überprüfen können, ob das Objekt an anderer Stelle nicht verwendet wird, und wenn sie an anderer Stelle verwendet wird, die Informationen für Sie anzeigen. Wenn Sie einen Verweis auf eine Variable aus einer Komponente oder einem Paket hinzufügen oder löschen, müssen Sie die Listen der Variablenverweis aktualisieren.

Derzeit werden die vom Referenz-Tracker unterstützten Arten von Objekten in der DTSObjectReferenceType Aufzählung aufgeführt.

Eine Laufzeitaufgabe oder Pipelinekomponente, die Variablen oder Sammlungen verwendet, verwendet die AddReference Methode, um eine Referenzliste von Objekten zu erstellen. Sie müssen auch einen Nutzungsort und eine Beschreibung für die Liste bereitstellen, indem Sie aufrufen SetListInfo. Beispielsweise würde eine Aufgabe mit einer einzelnen Variable den Namen als Standortinformationen verwenden und eine Beschreibung der Variablen als Verwendungsbeschreibung verwenden.

Aufgaben oder Komponenten, die verschiedene Verwendungen von Variablen oder Verbindungen vornehmen, können so viele separate Referenzlisten wie erforderlich erstellen. Die Komponente bedingter Split verwendet beispielsweise Variablen in Ausdrücken für Ausgabeausgaben, und Sie können eine separate Referenzliste für jeden Ausgabeausdruck erstellen, der Variablen verwendet. Sie legen den Komponentennamen als Verwendungsspeicherort fest und schließen den Ausdruck ein und wo er in der Beschreibung gefunden wird. Wenn dieselbe Variable in mehreren Ausdrücken verwendet wird, wird jeder Verwendungsort vom System nachverfolgt.

Es gibt separate DTSObjectReferenceType Enumerationen für schreibgeschützte Variablen und Lese-/Schreibvariablen. Mithilfe dieser Spezifikation können Sie in Verbindung mit der Variablensperre mit der VariableDispenser Klasse Informationen bereitstellen, die beim Beheben von Deadlock-Problemen nützlich sind.

Methoden

AddReference(String, DTSObjectReferenceType, Int32)

Diese Methode fügt einer Liste zur Verweisnachverfolgung einen Verweis hinzu.

DestroyList(Int32)

Diese Methode zerstört die angegebene Verweisliste aus der Verweisnachverfolgung.

Equals(Object)

Stellt fest, ob zwei Objektinstanzen gleich sind.

(Geerbt von DtsObject)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von DtsObject)
RemoveReference(String, DTSObjectReferenceType, Int32)

Entfernt einen Verweis aus einer vorhandenen Liste.

SetListInfo(Int32, String, String)

Diese Methode ermöglicht die Bereitstellung von Metadaten für eine vorhandene Verweisliste.

Gilt für: