Application.UpdateObjects Propriété

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é

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

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 à