Application.UpdateObjects Propiedad

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

*** Miembro desusado; ver Comentarios. Obtiene o establece un valor booleano que indica si se pueden actualizar objetos extensibles en el momento de la carga del paquete si se encuentra una versión actualizada.

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

Valor de propiedad

Boolean

True si los objetos extensibles se pueden actualizar en el momento de la carga del paquete cuando se encuentra una versión actualizada; de lo contrario, false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo alternar la UpdateObjects propiedad para habilitar o evitar actualizaciones. Establece en UpdateObjectstrue, imprime el valor de la propiedad , lo falseestablece en e imprime el valor de nuevo.

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  

Salida del ejemplo:

True

False

Comentarios

Nota

Este miembro se quitará en una versión futura de MicrosoftSQL Server. Evite usar este miembro en el nuevo trabajo de desarrollo y planee modificar las aplicaciones que usan actualmente este miembro.

Cuando hay nuevas versiones de objetos extensibles, como las tareas, enumeradores, Foreach proveedores de registro y administradores de conexiones disponibles, los paquetes existentes se pueden actualizar en tiempo de carga para hacer referencia a los nuevos objetos. Para ello, establezca en UpdateObjectstrue antes de cargar el paquete.

Cada objeto extensible implementa una CanUpdate propiedad . El tiempo de ejecución intenta cargar el paquete existente y, si encuentra una referencia a un objeto anterior, el paquete intenta actualizar sus referencias. Primero enumera todos los objetos extensibles que contiene, excepto , Pipelineque se trata por separado y localmente, y para cada objeto, llama a CanUpdate en el nuevo objeto pasando el identificador del antiguo. Si el nuevo objeto puede actualizar el objeto antiguo, el objeto antiguo se pasa al nuevo mediante el Update método y el XML se cambia en su lugar. De forma predeterminada, todos los objetos extensibles implementan CanUpdate para devolver false, en cuyo caso Update no hace nada al XML que se pasa.