DtsContainer.FailPackageOnFailure Propiedad

  • Referencia

Definición

Espacio de nombres:
Microsoft.SqlServer.Dts.Runtime
Ensamblado:
Microsoft.SqlServer.ManagedDTS.dll

Obtiene o establece un valor booleano que indica si se produce un error en el paquete cuando se produce un error en un contenedor secundario. Esta propiedad se utiliza en los contenedores, no en el propio paquete.

public:
 property bool FailPackageOnFailure { bool get(); void set(bool value); };
[Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyCategory(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "PropertyCategoryExecution")]
[Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "FailPackageOnFailureDesc")]
public bool FailPackageOnFailure { get; set; }
[<Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyCategory(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "PropertyCategoryExecution")>]
[<Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "FailPackageOnFailureDesc")>]
member this.FailPackageOnFailure : bool with get, set
Public Property FailPackageOnFailure As Boolean

Valor de propiedad

Boolean

true indica que un error en el contenedor establecerá los resultados de ejecución del paquete en error.

Atributos
LocalizablePropertyCategoryAttribute LocalizablePropertyDescriptionAttribute

Ejemplos

En el ejemplo de código siguiente se crea un Packageobjeto , que es una clase que hereda de DtsContainer. Package Muestra el uso de varias propiedades heredadas.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  
            Package pkg = new Package();  

            // Package name must be assigned.  
            pkg.Name = "My DtsContainer inheritance test package";  

            // Display the values that manually assigned.  
            Console.WriteLine("Package Name: {0}", pkg.Name);  

            // Packages are assigned the following default values when created.  
            Console.WriteLine("Package ID:           {0}", pkg.ID);  
            Console.WriteLine("FailPackageOnFailure: {0}", pkg.FailPackageOnFailure);  
            Console.WriteLine("FailParentOnFailure:  {0}", pkg.FailParentOnFailure);  
            Console.WriteLine("Locale ID:            {0}", pkg.LocaleID);  
            Console.WriteLine("Is DefaultLocaleID?   {0}", pkg.IsDefaultLocaleID);  
            Console.WriteLine("Isolation Level:      {0}", pkg.IsolationLevel);  
            Console.WriteLine("LoggingMode:          {0}", pkg.LoggingMode);  
            Console.WriteLine("MaximumErrorCount:    {0}", pkg.MaximumErrorCount);  
            Console.WriteLine("TransactionOption:    {0}", pkg.TransactionOption);  
        }  
    }  
}  

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  New Package()   

            ' Package name must be assigned.  
            pkg.Name = "My DtsContainer inheritance test package"  

            ' Display the values that manually assigned.  
            Console.WriteLine("Package Name: {0}", pkg.Name)  

            ' Packages are assigned the following default values when created.  
            Console.WriteLine("Package ID:           {0}", pkg.ID)  
            Console.WriteLine("FailPackageOnFailure: {0}", pkg.FailPackageOnFailure)  
            Console.WriteLine("FailParentOnFailure:  {0}", pkg.FailParentOnFailure)  
            Console.WriteLine("Locale ID:            {0}", pkg.LocaleID)  
            Console.WriteLine("Is DefaultLocaleID?   {0}", pkg.IsDefaultLocaleID)  
            Console.WriteLine("Isolation Level:      {0}", pkg.IsolationLevel)  
            Console.WriteLine("LoggingMode:          {0}", pkg.LoggingMode)  
            Console.WriteLine("MaximumErrorCount:    {0}", pkg.MaximumErrorCount)  
            Console.WriteLine("TransactionOption:    {0}", pkg.TransactionOption)  
        End Sub  
    End Class  
End Namespace

Salida del ejemplo:

Nombre del paquete: Mi paquete de prueba de herencia dtsContainer

Id. de paquete: {2C2FAA96-35BA-4C5E-A39A-C5D7D30A0D79}

FailPackageOnFailure: False

FailParentOnFailure: False

Identificador de configuración regional: 1033

¿DefaultLocaleID? Falso

Nivel de aislamiento: Serializable

LoggingMode: UseParentSetting

MaximumErrorCount: 1

TransactionOption: Compatible

Comentarios

Si FailPackageOnFailure es true y el resultado de la ejecución de un contenedor es un error, el resultado de la ejecución asignado al paquete que es el elemento primario del contenedor con errores también es un error. Esto da como resultado la terminación del paquete. Este evento define un error de paquete reiniciable. Los paquetes que no se completan porque no se ha cancelado su ejecución no se pueden reiniciar. Para obtener más información, vea Restart Packages by Using Checkpoints.

Esta propiedad no se puede establecer en .Package Si se establece este valor true en en el paquete, se producirá un error.

Se aplica a