ComponentUpgradeFailedException Class
The exception that is thrown when the PerformUpgrade method of a component fails.
Inheritance Hierarchy
System.Object
System.Exception
System.ApplicationException
Microsoft.SqlServer.Dts.Pipeline.ComponentUpgradeFailedException
Namespace: Microsoft.SqlServer.Dts.Pipeline
Assembly: Microsoft.SqlServer.PipelineHost (in Microsoft.SqlServer.PipelineHost.dll)
Syntax
'Declaration
<SerializableAttribute> _
Public Class ComponentUpgradeFailedException _
Inherits ApplicationException
'Usage
Dim instance As ComponentUpgradeFailedException
[SerializableAttribute]
public class ComponentUpgradeFailedException : ApplicationException
[SerializableAttribute]
public ref class ComponentUpgradeFailedException : public ApplicationException
[<SerializableAttribute>]
type ComponentUpgradeFailedException =
class
inherit ApplicationException
end
public class ComponentUpgradeFailedException extends ApplicationException
The ComponentUpgradeFailedException type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
ComponentUpgradeFailedException | Initializes a new instance of the ComponentUpgradeFailedException class with the IdentificationString of the component that failed to upgrade. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Data | (Inherited from Exception.) |
|
HelpLink | (Inherited from Exception.) |
|
HResult | (Inherited from Exception.) |
|
InnerException | (Inherited from Exception.) |
|
Message | (Inherited from Exception.) |
|
Source | (Inherited from Exception.) |
|
StackTrace | (Inherited from Exception.) |
|
TargetSite | (Inherited from Exception.) |
Top
Methods
| Name | Description | |
|---|---|---|
|
Equals | (Inherited from Object.) |
.gif "Protected method") |
Finalize | (Inherited from Object.) |
|
GetBaseException | (Inherited from Exception.) |
|
GetHashCode | (Inherited from Object.) |
|
GetObjectData | Security Critical. (Inherited from Exception.) |
|
GetType | (Inherited from Exception.) |
|
MemberwiseClone | (Inherited from Object.) |
|
ToString | (Inherited from Exception.) |
Top
Events
| Name | Description | |
|---|---|---|
.gif "Protected event") |
SerializeObjectState | (Inherited from Exception.) |
Top
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 IDTSComponentMetaData100 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.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.