Application.UpdatePackage Proprietà

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Ottiene o imposta un valore booleano che indica se è possibile aggiornare i pacchetti quando viene trovata una versione aggiornata.

public:
 property bool UpdatePackage { bool get(); void set(bool value); };

public bool UpdatePackage { get; set; }

member this.UpdatePackage : bool with get, set

Public Property UpdatePackage As Boolean

Valore della proprietà

Boolean

true se i pacchetti possono essere aggiornati quando viene trovata una versione aggiornata; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio di codice seguente viene illustrato come abilitare e disabilitare gli aggiornamenti. Imposta su UpdatePackagetrue, stampa il valore, reimposta il valore della proprietà su falsee stampa nuovamente il valore.

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

            Boolean updatePkg = true;  
            app.UpdatePackage = updatePkg;  
            Console.WriteLine(app.UpdatePackage);  

            updatePkg = false;  
            app.UpdatePackage = updatePkg;  
            Console.WriteLine(app.UpdatePackage);  
        }  
    }  

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

            Dim updatePkg As Boolean = True   
            app.UpdatePackage = updatePkg  
            Console.WriteLine(app.UpdatePackage)  

            updatePkg = False  
            app.UpdatePackage = updatePkg  
            Console.WriteLine(app.UpdatePackage)  
        End Sub  
End Class  

Esempio di output

True

False

Commenti

Se gli oggetti estendibili, ad esempio attività, enumeratori, Foreach provider di log e gestioni connessioni vengono aggiornati, i pacchetti meno recenti possono essere aggiornati in fase di caricamento. Affinché ciò si verifichi, le due proprietà seguenti devono essere impostate su true nell'oggetto dell'applicazione prima di caricare: UpdatePackagee UpdateObjects.

Ogni oggetto estendibile deve implementare anche la relativa CanUpdate proprietà.

Il runtime tenta di caricare il pacchetto precedente e, se trova un oggetto precedente, tenta un aggiornamento. Il runtime enumera prima tutti gli oggetti estendibili che contiene, escluso , Pipelineche viene trattato separatamente e in locale. Per ogni oggetto, il runtime chiama CanUpdate quindi sui nuovi oggetti, passando l'ID dell'oggetto precedente. Se il nuovo oggetto può aggiornare quello precedente, l'oggetto precedente viene passato al nuovo usando il metodo e il relativo Update codice XML viene modificato sul posto. Per impostazione predefinita, tutti gli oggetti estendibili implementano CanUpdate per restituire false. Pertanto, il codice XML passato non viene aggiornato.