Application.UpdateObjects Eigenschaft

  • Referenz

Definition

Namespace:
Microsoft.SqlServer.Dts.Runtime
Assembly:
Microsoft.SqlServer.ManagedDTS.dll

Mitglied veraltet; siehe Hinweise. Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob erweiterbare Objekte zur Paketladezeit aktualisiert werden können, wenn eine aktualisierte Version gefunden wird.

public:
 property bool UpdateObjects { bool get(); void set(bool value); };
public bool UpdateObjects { get; set; }
member this.UpdateObjects : bool with get, set
Public Property UpdateObjects As Boolean

Eigenschaftswert

Boolean

true, wenn erweiterbare Objekte zum Zeitpunkt des Paketladevorgangs aktualisiert werden können, wenn eine aktualisierte Version gefunden wird; andernfalls "false".

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die UpdateObjects Eigenschaft umschalten, um Updates zu aktivieren oder zu verhindern. Er legt den Wert auf UpdateObjectstrue, druckt den Wert der Eigenschaft, legt ihn fest falseund druckt den Wert erneut aus.

class ApplicationTests  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  

            Boolean updateObjs = true;  
            app.UpdateObjects = updateObjs;  
            Console.WriteLine(app.UpdateObjects);  

            updateObjs = false;  
            app.UpdateObjects = updateObjs;  
            Console.WriteLine(app.UpdateObjects);  
        }  
    }  

Class ApplicationTests  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   

            Dim updateObjs As Boolean =  True   
            app.UpdateObjects = updateObjs  
            Console.WriteLine(app.UpdateObjects)  

            updateObjs = False  
            app.UpdateObjects = updateObjs  
            Console.WriteLine(app.UpdateObjects)  
        End Sub  
End Class

Beispielausgabe:

True

False

Hinweise

Hinweis

Dieses Mitglied wird in einer zukünftigen Version von MicrosoftSQL Server entfernt. Vermeiden Sie die Verwendung dieses Mitglieds in der neuen Entwicklungsarbeit, und planen Sie, Anwendungen zu ändern, die derzeit dieses Mitglied verwenden.

Wenn neue Versionen erweiterbarer Objekte wie Aufgaben, Foreach Aufzählungen, Protokollanbieter und Verbindungsmanager verfügbar werden, können vorhandene Pakete zur Ladezeit aktualisiert werden, um auf die neuen Objekte zu verweisen. Sie können dies tun, indem Sie die Einstellung auf " UpdateObjectstrue Vor dem Laden des Pakets" festlegen.

Jedes erweiterbare Objekt implementiert eine CanUpdate Eigenschaft. Die Laufzeit versucht, das vorhandene Paket zu laden, und wenn ein Verweis auf ein älteres Objekt gefunden wird, versucht das Paket, seine Verweise zu aktualisieren. Zunächst werden alle erweiterbaren Objekte aufgezählt, die sie enthält, ausgenommen das Pipeline, das separat und lokal behandelt wird, und für jedes Objekt ruft das neue Objekt auf CanUpdate , das die ID des alten Objekts übergibt. Wenn das neue Objekt das alte Objekt aktualisieren kann, wird das alte Objekt über die Update Methode an die neue übergeben, und der XML-Code wird dort geändert. Standardmäßig implementieren CanUpdate alle erweiterbaren Objekte, die zurückgegeben falsewerden sollen, in diesem Fall Update nichts an den XML-Code, der übergeben wird.

Gilt für: