Application.UpdateObjects Propriété

Référence

Définition

Espace de noms:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

*** Membre déconseillé ; consultez les Remarques. Obtient ou définit une valeur booléenne qui indique si des objets extensibles peuvent être mis à jour au moment du chargement du package si une version mise à jour est trouvée.

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

Valeur de propriété

Boolean

true si des objets extensibles peuvent être mis à jour au moment du chargement du package lorsqu’une version mise à jour est trouvée ; sinon, false.

Exemples

L’exemple de code suivant montre comment désactiver la UpdateObjects propriété pour activer ou empêcher les mises à jour. Il définit la UpdateObjectstruevaleur , imprime la valeur de la propriété, la définit falsesur , et imprime à nouveau la valeur.

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

Exemple de sortie :

True

False

Remarques

Notes

Ce membre sera supprimé dans une prochaine version de MicrosoftSQL Server. Évitez d’utiliser ce membre dans le nouveau travail de développement et prévoyez de modifier des applications qui utilisent actuellement ce membre.

Lorsque de nouvelles versions d’objets extensibles tels que les tâches, les énumérateurs, Foreach les fournisseurs de journaux et les gestionnaires de connexions deviennent disponibles, les packages existants peuvent être mis à jour au moment du chargement pour référencer les nouveaux objets. Pour ce faire, définissez la UpdateObjects valeur true avant de charger le package.

Chaque objet extensible implémente une CanUpdate propriété. Le runtime tente de charger le package existant et, s’il trouve une référence à un objet plus ancien, le package tente de mettre à jour ses références. Il énumère tout d’abord tous les objets extensibles qu’il contient, à l’exclusion du Pipeline, qui est traité séparément et localement, et pour chaque objet, appelle CanUpdate le nouvel objet en passant l’ID de l’ancien. Si le nouvel objet peut mettre à jour l’ancien objet, l’ancien objet est passé à celui-ci par le biais de la Update méthode, et le code XML est modifié en place. Par défaut, tous les objets extensibles implémentent CanUpdate pour retourner false, auquel cas Update rien n’est transmis au code XML passé.

S’applique à

Partager via