Share via

DTSTransactionOption Enum

Definition

Namespace:
Microsoft.SqlServer.Dts.Runtime
Assembly:
Microsoft.SqlServer.ManagedDTS.dll

Describes transaction supportability and specifies whether a container participates in transactions.

public enum class DTSTransactionOption
public enum DTSTransactionOption
type DTSTransactionOption = 
Public Enum DTSTransactionOption
Inheritance
Enum
DTSTransactionOption

Fields

Name Value Description
NotSupported 0

Specifies that no transaction will be started for this container, and consequently, the outcome of the current transaction, if one has been started by a parent container, will not affect the data that may be altered during execution of this container. This means that changes will not roll back, even if the parent container started a transaction.
Supported 1

Specifies that this container will not start a transaction. However, it will participate in a transaction if the parent container started one. This is the default.
Required 2

Specifies that this container will cause a new transaction to be started unless the parent container already has a transaction, in which case, the parent’s transaction will be joined.

Examples

The following code example shows the use of this enumeration to change the value of the Package.TransactionOption.

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();  

            // Display the default value of TransactionOption.  
            Console.WriteLine("TransactionOption:    {0}", pkg.TransactionOption);  

            // Modify the value.  
            pkg.TransactionOption = DTSTransactionOption.Required;  

            // Display the new value of TransactionOption.  
            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()   

            ' Display the default value of TransactionOption.  
            Console.WriteLine("TransactionOption:    {0}", pkg.TransactionOption)  

            ' Modify the value.  
            pkg.TransactionOption = DTSTransactionOption.Required  

            ' Display the new value of TransactionOption.  
            Console.WriteLine("TransactionOption:    {0}", pkg.TransactionOption)  
        End Sub  
    End Class  
End Namespace

Sample Output:

TransactionOption: Supported

TransactionOption: Required

Remarks

This enumeration is used by containers to indicate whether the container participates in transactions.

Applies to