Application.UpdateObjects Proprietà

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

*** Membro deprecato; vedere la sezione Osservazioni. Ottiene o imposta un valore booleano che indica se gli oggetti estendibili possono essere aggiornati in fase di caricamento del pacchetto se viene trovata una versione aggiornata.

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à

Boolean

true se gli oggetti estendibili possono essere aggiornati in fase di caricamento del pacchetto quando viene trovata una versione aggiornata; in caso contrario, false.

Esempio

Nell'esempio di codice seguente viene illustrato come attivare o impedire l'attivazione o l'attivazione UpdateObjects degli aggiornamenti. Imposta su UpdateObjectstrue, stampa il valore della proprietà , lo falseimposta su e stampa nuovamente 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  

Esempio di output

True

False

Commenti

Nota

Questo membro verrà rimosso in una versione futura di MicrosoftSQL Server. Evitare di usare questo membro in un nuovo lavoro di sviluppo e pianificare la modifica delle applicazioni che attualmente usano questo membro.

Quando diventano disponibili nuove versioni di oggetti estendibili, ad esempio attività, Foreach enumeratori, provider di log e gestioni connessioni, i pacchetti esistenti possono essere aggiornati in fase di caricamento per fare riferimento ai nuovi oggetti. A tale scopo, impostare su UpdateObjects prima true di caricare il pacchetto.

Ogni oggetto estendibile implementa una CanUpdate proprietà . Il runtime tenta di caricare il pacchetto esistente e, se trova un riferimento a un oggetto meno recente, il pacchetto tenta di aggiornare i relativi riferimenti. Enumera innanzitutto tutti gli oggetti estendibili che contiene, escluso , Pipelineche viene trattato separatamente e localmente e per ogni oggetto, chiama CanUpdate sul nuovo oggetto passando l'ID di quello precedente. Se il nuovo oggetto può aggiornare l'oggetto precedente, l'oggetto precedente viene passato al nuovo tramite il Update metodo e il codice XML viene modificato sul posto. Per impostazione predefinita, tutti gli oggetti estendibili implementano CanUpdate per restituire false, nel qual caso Update non esegue alcuna operazione al codice XML passato.