DtsContainer.FailPackageOnFailure Properti

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Mendapatkan atau mengatur Boolean yang menunjukkan apakah paket gagal ketika kontainer anak gagal. Properti ini digunakan pada kontainer, bukan paket itu sendiri.

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

Nilai Properti

Boolean

true menunjukkan bahwa kegagalan dalam kontainer akan mengatur hasil eksekusi paket ke kegagalan.

Atribut

LocalizablePropertyCategoryAttribute LocalizablePropertyDescriptionAttribute

Contoh

Contoh kode berikut membuat Package, yang merupakan kelas yang mewarisi dari DtsContainer. menunjukkan Package penggunaan beberapa properti yang diwariskan.

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  

Contoh Output:

Nama Paket: Paket pengujian pewarisan DtsContainer saya

ID Paket: {2C2FAA96-35BA-4c5e-A39A-C5D7D30A0D79}

FailPackageOnFailure: False

FailParentOnFailure: False

ID Lokal: 1033

Apakah DefaultLocaleID? FALSE

Tingkat Isolasi: Dapat diserialisasikan

LoggingMode: UseParentSetting

MaximumErrorCount: 1

TransactionOption: Didukung

Keterangan

Jika FailPackageOnFailure adalah true dan hasil eksekusi kontainer adalah kegagalan, hasil eksekusi yang ditetapkan ke paket yang merupakan induk kontainer yang gagal juga gagal. Hal ini mengalihkan paket berakhir. Kejadian ini mendefinisikan kegagalan paket yang dapat dimulai ulang. Paket yang tidak selesai karena eksekusinya dibatalkan tidak dapat dimulai ulang. Untuk informasi selengkapnya, lihat Memulai Ulang Paket dengan Menggunakan Titik Pemeriksaan.

Properti ini tidak dapat diatur pada Package. Mengatur nilai ini ke true pada paket akan mengakibatkan kesalahan.