DtsEnumerator.MoveNext Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Desplaza el enumerador al siguiente elemento de la colección.

public:
 virtual bool MoveNext();

public bool MoveNext ();

abstract member MoveNext : unit -> bool
override this.MoveNext : unit -> bool

Public Function MoveNext () As Boolean

Devoluciones

Boolean

true si el enumerador se ha avanzado correctamente al siguiente elemento; false si el enumerador ha pasado el final de la colección.

Implementaciones

MoveNext()

Ejemplos

En el ejemplo de código siguiente se agrega una tarea a un paquete y, a continuación, se ejecuta el paquete. La colección warnings se crea mediante la creación de un WarningEnumerator, que hereda de esta DtsEnumerator clase, y muestra cada descripción de advertencia mediante Current métodos y MoveNext para revisar las advertencias de la colección.

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

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package package = new Package();  
            Console.WriteLine("Package warnings count before running: {0}", package.Warnings.Count);  

            TaskHost taskH2 = (TaskHost)package.Executables.Add("STOCK:SendMailTask");  
            taskH2.FailPackageOnFailure = false;  
            taskH2.FailParentOnFailure = false;  
            Console.WriteLine("SendMailTask: {0}", taskH2.ID);  

            // Test that warnings were successfully added to the collection.  
            package.MaximumErrorCount = 100;  
            package.FailPackageOnFailure = false;  
            package.FailParentOnFailure = false;  
            package.DelayValidation = true;  
            package.Execute();  

            Console.WriteLine("Package warnings count after running the package: {0}", package.Warnings.Count);  

            // Create the enumerator.  
            WarningEnumerator myEnumerator = package.Warnings.GetEnumerator();  
            Console.WriteLine("The collection contains the following values:");  
            int i = 0;  
            while ((myEnumerator.MoveNext()) && (myEnumerator.Current != null))  
                Console.WriteLine("[{0}] {1}", i++, myEnumerator.Current.Description);  
        }  
    }  
}  

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

Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim package As Package =  New Package()   
            Console.WriteLine("Package warnings count before running: {0}", package.Warnings.Count)  

            Dim taskH2 As TaskHost = CType(package.Executables.Add("STOCK:SendMailTask"), TaskHost)  
            taskH2.FailPackageOnFailure = False  
            taskH2.FailParentOnFailure = False  
            Console.WriteLine("SendMailTask: {0}", taskH2.ID)  

            ' Test that warnings were successfully added to the collection.  
            package.MaximumErrorCount = 100  
            package.FailPackageOnFailure = False  
            package.FailParentOnFailure = False  
            package.DelayValidation = True  
            package.Execute()  

            Console.WriteLine("Package warnings count after running the package: {0}", package.Warnings.Count)  

            ' Create the enumerator.  
            Dim myEnumerator As WarningEnumerator =  package.Warnings.GetEnumerator()   
            Console.WriteLine("The collection contains the following values:")  
            Dim i As Integer =  0   
            While (myEnumerator.MoveNext()) &&(myEnumerator.Current <> Nothing)  
                Console.WriteLine("[{0}] {1}",i = Console.WriteLine("[{0}] {1}",i + 1  
            End While  
        End Sub  
    End Class  
End Namespace  

Salida del ejemplo:

Recuento de advertencias de paquete antes de ejecutar: 0

SendMailTask: {34CAEFF9-64BF-401D-B646-C88B705DB971}

Recuento de advertencias de paquete después de ejecutar el paquete: 2

La colección contiene los siguientes valores:

[0] La dirección de la línea From no se forma correctamente. Falta un @ o no es válido.

[1] El asunto está vacío

Comentarios

Después de crear un enumerador o después de una llamada al Reset método , se coloca un enumerador antes del primer elemento de la colección y la primera llamada para MoveNext mover el enumerador sobre el primer elemento de la colección.

Después de pasar el final de la colección, se devuelven false las llamadas subsiguientes hasta Reset que se llama a MoveNext .

Un enumerador sigue siendo válido mientras la colección permanezca inalterada. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador se invalida irrecuperablemente y la siguiente llamada a MoveNext o Reset produce un InvalidOperationException.