VariableDispenser.Reset Método

Esta página é útil?

Algum comentário adicional?

Os comentários serão enviados à Microsoft: quando você pressionar o botão Enviar, seus comentários serão usados para aprimorar os produtos e os serviços da Microsoft. Política de Privacidade.

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Desmarca a lista somente leitura e a lista leitura/gravação quando a chamada para GetVariables(Variables) apresenta falha.

public:
 void Reset();

public void Reset ();

member this.Reset : unit -> unit

Public Sub Reset ()

Exemplos

O exemplo de código a seguir bloqueia uma coleção de variáveis e, em seguida, determina se a coleção de variáveis está bloqueada antes de desbloqueá-las. Se o bloqueio tiver falhado, Reset será chamado.

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

namespace Microsoft.SqlServer.SSIS.Sample  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package pkg = new Package();  
            Variables vars = null;  
            VariableDispenser variableDispenser = pkg.VariableDispenser;  
            variableDispenser.LockForRead("System::PackageName");  
            variableDispenser.LockForRead("System::OfflineMode");  
            variableDispenser.GetVariables(ref vars);             
            // Determine whether the variable collection is locked.  
            Boolean isLocked = vars.Locked;  

            // Verify the value of vars.Locked. If the lock failed,  
            // call Reset.  
            if (isLocked)  
            {  
                vars.Unlock();  
            }  
            else  
            {  
                variableDispenser.Reset();  
            }  
        }  
    }  
}  

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

Namespace Microsoft.SqlServer.SSIS.Sample  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim pkg As Package =  New Package()   
            Dim vars As Variables =  Nothing   
            Dim variableDispenser As VariableDispenser =  pkg.VariableDispenser   
            variableDispenser.LockForRead("System::PackageName")  
            variableDispenser.LockForRead("System::OfflineMode")  
            variableDispenser.GetVariables( vars)  
            ' Determine whether the variable collection is locked.  
            Dim isLocked As Boolean =  vars.Locked   

            ' Verify the value of vars.Locked. If the lock failed,  
            ' call Reset.  
            If isLocked = True Then  
                vars.Unlock()  
            Else   
                variableDispenser.Reset()  
            End If  
        End Sub  
    End Class  
End Namespace  

Comentários

Esse método pode ser usado para limpar a lista somente leitura e a lista de bloqueio de leitura/gravação depois que uma chamada para GetVariables falha. Se uma chamada para GetVariables falhar, as listas de bloqueio não serão limpas e, portanto, se você chamar GetVariables novamente, será feita uma tentativa de bloquear as mesmas variáveis. Se você quiser bloquear novamente as mesmas variáveis, chame GetVariables novamente sem chamar Reset primeiro. Ou, você pode optar por liberar as listas usando esse método e abandonar a operação até que todas as variáveis necessárias estejam disponíveis e possam ser bloqueadas ao mesmo tempo.

Além disso, o Reset método será usado se você receber uma falha de GetVariables e desejar bloquear um conjunto de variáveis completamente diferente e não relacionado em seguida. Você deve chamar Reset para limpar as listas de bloqueios e, em seguida, reabastecer as listas de bloqueios usando os LockForRead LockForWrite métodos,, LockOneForRead e LockOneForWrite .