MessageQueueTask.SuspendRequired Propiedad

Gets or sets a Boolean that indicates if the task should suspend when it encounters a breakpoint. This value is set by the runtime engine for tasks and containers when a breakpoint is encountered.

Espacio de nombres:  Microsoft.SqlServer.Dts.Tasks.MessageQueueTask
Ensamblado:  Microsoft.SqlServer.MSMQTask (en Microsoft.SqlServer.MSMQTask.dll)

Sintaxis

'Declaración
Public Property SuspendRequired As Boolean 
    Get 
    Set
'Uso
Dim instance As MessageQueueTask 
Dim value As Boolean 

value = instance.SuspendRequired

instance.SuspendRequired = value

public bool SuspendRequired { get; set; }

public:
virtual property bool SuspendRequired {
    bool get () sealed;
    void set (bool value) sealed;
}

abstract SuspendRequired : bool with get, set 
override SuspendRequired : bool with get, set

final function get SuspendRequired () : boolean 
final function set SuspendRequired (value : boolean)

Valor de la propiedad

Tipo: System.Boolean
true if the task suspends when it encounters a breakpoint.

Implementa

IDTSSuspend.SuspendRequired

Comentarios

The property is not set in code. It is set by the runtime for tasks and containers when a breakpoint is encountered.

However, you will need to provide code for this method, which is inherited from the IDTSSuspend class, if you write a multi-threaded custom task that exposes breakpoints. If your task is single threaded, which means that your implementation of Execute in your custom task does not start new threads, you do not need to implement this interface. For more information on writing custom tasks, see Desarrollar una tarea personalizada.

Ejemplos

The following code example is an example of an overridden SuspendRequired property for a custom task.

public bool SuspendRequired 
{
     get
    { 
        // m_suspendRequired is an Private integer declared in the custom task. 
        return m_suspendRequired != 0; 
    }

    set
    {
    // This lock is also taken by Suspend().  Since it is possible for the package to be 
    // suspended and resumed in quick succession, this property "put" might happen 
    // before the actual Suspend() call.  Without the lock, the Suspend() might reset 
    // the canExecute event after we set it to abort the suspension. 
         lock (this) 
    {
        Interlocked.Exchange(ref m_suspendRequired, value ? 1 : 0); 
            if (!value) 
                ResumeExecution(); 
    }
}

Public ReadOnly Property SuspendRequired() As Boolean
    Get 
        ' m_suspendRequired is an Private integer declared in the custom task. 
        Return m_suspendRequired <> 0
     End Get

Public WriteOnly Property SuspendRequired() As Boolean
    Set (ByVal Value As Boolean) 
        ' This lock is also taken by Suspend().  Since it is possible for the package to be 
        ' suspended and resumed in quick succession, this property "put" might happen 
       ' before the actual Suspend() call.  Without the lock, the Suspend() might reset
       ' the canExecute event after it is set to abort the suspension. 
         lock (Me)
         {
               Interlocked.Exchange(m_suspendRequired, value ? 1 : 0) 
                     If Not value Then
                       ResumeExecution()
                     End If
             }
         End Set
End Property

Vea también

Referencia

MessageQueueTask Clase

Espacio de nombres Microsoft.SqlServer.Dts.Tasks.MessageQueueTask