共用方式為

Application.UpdatePackage Property

Gets or sets a Boolean that indicates whether packages can be updated when an updated version is found.

命名空間: Microsoft.SqlServer.Dts.Runtime
組件: Microsoft.SqlServer.ManagedDTS (in microsoft.sqlserver.manageddts.dll)

語法

'宣告
Public Property UpdatePackage As Boolean

public bool UpdatePackage { get; set; }

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

/** @property */
public boolean get_UpdatePackage ()

/** @property */
public void set_UpdatePackage (boolean value)

public function get UpdatePackage () : boolean

public function set UpdatePackage (value : boolean)

屬性值

true if packages can be updated when an updated version is found; otherwise, false. The default value is false.

備註

If extensible objects, such as tasks, Foreach enumerators, log providers, and connection managers are updated, older packages can be updated at load time. For that to occur, the following two properties must be set to true in the application object before loading: UpdatePackage, and UpdateObjects.

Each extensible object must also implement its CanUpdate property.

The runtime tries to load the old package, and if it finds an older object, attempts an update. The runtime first enumerates all the extensible objects it contains, excluding the Pipeline, which is treated separately and locally. For each object, the runtime then calls CanUpdate on the new objects, passing the ID of the old object. If the new object can update the old one, the old object is passed to the new one by using its Update method, and its XML is changed in place. By default, all extensible objects implement CanUpdate to return false; therefore, the XML that is passed is not updated.

範例

The following code example shows how to enable and disable updates. It sets the UpdatePackage to true, prints the value, resets the value of the property to false, and prints out the value again.

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

Sample Output:

True

False

執行緒安全性

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

平台

開發平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

目標平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

請參閱

參考

Application Class
Application Members
Microsoft.SqlServer.Dts.Runtime Namespace

  • Last updated on