ComponentUpgradeFailedException Class

Article
12/03/2008

The exception that is thrown when the PerformUpgrade method of a component fails.

Namespace: Microsoft.SqlServer.Dts.Pipeline
Assembly: Microsoft.SqlServer.PipelineHost (in microsoft.sqlserver.pipelinehost.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public Class ComponentUpgradeFailedException
    Inherits ApplicationException

[SerializableAttribute] 
public class ComponentUpgradeFailedException : ApplicationException

[SerializableAttribute] 
public ref class ComponentUpgradeFailedException : public ApplicationException

/** @attribute SerializableAttribute() */ 
public class ComponentUpgradeFailedException extends ApplicationException

SerializableAttribute 
public class ComponentUpgradeFailedException extends ApplicationException

Remarks

When the version of a component, specified by the CurrentVersion property, that is stored in the package XML is less than the CurrentVersion property of the component on the local computer, PerformUpgrade is called. This method gives the component the opportunity to upgrade the IDTSComponentMetaData90 in the package XML to match the current version. If the component does not override the base class implementation of PerformUpgrade or if an exception occurs during the component's implementation of this method, then ComponentUpgradeFailedException is thrown.

Inheritance Hierarchy

System.Object
   System.Exception
     System.ApplicationException
      Microsoft.SqlServer.Dts.Pipeline.ComponentUpgradeFailedException

Thread Safety

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.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms