Application.UpdateObjects Proprietà

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

Valore della proprietà

Vero se gli oggetti estensibili possono essere aggiornati al caricamento del pacchetto quando viene trovata una versione aggiornata; altrimenti, falso.

Esempio

Il seguente esempio di codice mostra come attivare o impedire aggiornamenti nella UpdateObjects proprietà. Imposta il UpdateObjects valore su true, stampa il valore della proprietà, lo imposta a false, e stampa di nuovo il valore.

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  

Output di esempio:

True

False

Commenti

Quando diventano disponibili nuove versioni di oggetti estensibili come compiti, Foreach enumeratori, provider di log e gestori di connessioni, i pacchetti esistenti possono essere aggiornati al momento del caricamento per fare riferimento ai nuovi oggetti. Puoi farlo impostando il UpdateObjects modo a true prima di caricare il pacco.

Ogni oggetto estensibile implementa una CanUpdate proprietà. Il runtime cerca di caricare il pacchetto esistente e, se trova un riferimento a un oggetto più vecchio, il pacchetto cerca di aggiornare i suoi riferimenti. Innanzitutto enumera tutti gli oggetti estensionali che contiene, escludendo il Pipeline, che viene trattato separatamente e localmente, e per ogni oggetto chiama CanUpdate il nuovo oggetto che passa l'ID di quello vecchio. Se il nuovo oggetto può aggiornare il vecchio, il vecchio oggetto viene passato al nuovo tramite il Update metodo e l'XML viene modificato in posizione. Di default, tutti gli oggetti estensibili implementano CanUpdate per restituire false, nel qual caso Update non fa nulla all'XML che viene passato.