TaskInfoEnumerator.Current Propiedad

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Obtiene el objeto TaskInfo actual de la colección.

public:
 property Microsoft::SqlServer::Dts::Runtime::TaskInfo ^ Current { Microsoft::SqlServer::Dts::Runtime::TaskInfo ^ get(); };

public Microsoft.SqlServer.Dts.Runtime.TaskInfo Current { get; }

member this.Current : Microsoft.SqlServer.Dts.Runtime.TaskInfo

Public ReadOnly Property Current As TaskInfo

Valor de propiedad

TaskInfo

Objeto TaskInfo actual.

Ejemplos

En el ejemplo de código siguiente se crea un enumerador y, a continuación, se usan los Current métodos y MoveNext para navegar por la colección.

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

namespace TaskInfos_Item  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  
            TaskInfos tInfos = app.TaskInfos;  
            //Create the Enumerator.  
            TaskInfoEnumerator myEnumerator = tInfos.GetEnumerator();  
            Console.WriteLine("The collection contains the following values:");  
            int i = 0;  
            while ((myEnuemrator.MoveNext()) && (myEnuemrator.Current != null))  
                Console.WriteLine("[{0}] {1}", i++, myEnuemrator.Current.Name);  

            Console.WriteLine();  
        }  
    }  
}  

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

Namespace TaskInfos_Item  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   
            Dim tInfos As TaskInfos =  app.TaskInfos   
            'Create the Enumerator.  
            Dim myEnumerator As TaskInfoEnumerator =  tInfos.GetEnumerator()   
            Console.WriteLine("The collection contains the following values:")  
            Dim i As Integer =  0   
            While (myEnuemrator.MoveNext()) &&(myEnuemrator.Current <> Nothing)  
            Console.WriteLine("[{0}] {1}",i = Console.WriteLine("[{0}] {1}",i + 1  
            End While  

            Console.WriteLine()  
        End Sub  
    End Class  
End Namespace  

Salida de ejemplo:

La colección contiene los siguientes valores:

[0] Tarea Ejecutar paquete

[1] tarea de Data Flow

[2] SQL Server Analysis Services tarea Ejecutar DDL

[3] tarea de procesamiento de SQL Server Analysis Services

[4] Tarea inserción masiva

[5] Tarea consulta de minería de datos

[6] Tarea Ejecutar proceso

[7] Tarea Sistema de archivos

[8] Tarea Protocolo de transferencia de archivos

Comentarios

Después de crear un enumerador o después de una llamada al Reset método , MoveNext se debe llamar al método para avanzar el enumerador al primer elemento de la colección antes de que el enumerador pueda leer el valor de la Current propiedad; de lo contrario, Current no está definido y produce una excepción.

Currenttambién produce una excepción si se devuelve falsela última llamada a MoveNext , que indica el final de la colección.

Currentno mueve la posición del enumerador y las llamadas consecutivas al objeto devuelven el mismo objeto hasta que MoveNext se llama a Current o Reset .

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 y se convierte en irrecuperable; por lo tanto, la siguiente llamada a MoveNext o Reset produce una InvalidOperationExceptionexcepción . Si la colección se modifica entre las llamadas a MoveNext y Current, Current devuelve el elemento en el que se establece, incluso si el enumerador se ha invalidado.