다음을 통해 공유


DtsContainer.FailPackageOnFailure 속성

정의

자식 컨테이너가 실패할 때 패키지가 실패하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. 이 속성은 패키지 자체가 아닌 컨테이너에 사용됩니다.

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

속성 값

true는 컨테이너의 오류가 패키지 실행 결과를 실패로 설정했음을 나타냅니다.

특성

예제

다음 코드 예제에서는 상속되는 클래스인 을 만듭니다PackageDtsContainer. 여러 Package 상속된 속성의 사용이 표시됩니다.

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  

샘플 출력:

패키지 이름: 내 DtsContainer 상속 테스트 패키지

패키지 ID: {2C2FAA96-35BA-4C5E-A39A-C5D7D30A0D79}

FailPackageOnFailure: False

FailParentOnFailure: False

로캘 ID: 1033

DefaultLocaleID인가요? 아니요

격리 수준: 직렬화 가능

LoggingMode: UseParentSetting

MaximumErrorCount: 1

TransactionOption: 지원됨

설명

true 컨테이너의 실행 결과가 실패인 경우 FailPackageOnFailure 실패한 컨테이너의 부모인 패키지에 할당된 실행 결과도 실패합니다. 그러면 패키지가 종료됩니다. 이 이벤트는 다시 시작할 수 있는 패키지 오류를 정의합니다. 실행이 취소되어 완료되지 않은 패키지는 다시 시작할 수 없습니다. 자세한 내용은 검사점을 사용하여 패키지 다시 시작을 참조하세요.

이 속성은 .에 Package설정할 수 없습니다. 이 값을 true 패키지에 설정하면 오류가 발생합니다.

적용 대상