TaskInfoEnumerator.Current Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает текущий TaskInfo объект из коллекции.
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
Значение свойства
Текущий TaskInfo объект.
Примеры
Следующий пример кода создаёт переписчик, а затем использует методы Current и MoveNext для навигации по коллекции.
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
Пример выходных данных
Коллекция содержит следующие значения:
[0] Выполнить задачу пакета
[1] Задача Поток данных
[2] SQL Server Analysis Services выполнить задачу DDL
[3] Задача обработки SQL Server Analysis Services
[4] Задача по вставке массового объема
[5] Задача запроса по добыче данных
[6] Выполнить процессную задачу
[7] Задача файловой системы
[8] Задача протокола передачи файлов
Комментарии
После создания переписчика или после вызова Reset метода MoveNext необходимо вызвать метод для перемещения перечислителя к первому элементу коллекции до того, как перечислитель сможет прочитать значение Current свойства; в противном случае Current он не определен и создаёт исключение.
Current также вызывает исключение, если последний вызов MoveNext возвращаемого falseобъекта, указывающий конец коллекции.
Current не перемещает положение переписчика, и последовательные вызовы Current возвращают тот же объект, пока не будет вызвано либо или MoveNextReset .
Перечислитель остается допустимым, пока коллекция остается неизменной. Если в коллекцию вносятся изменения, такие как добавление, изменение или удаление элементов, переписчик считается недействительным и становится невосстановимым; Таким образом, следующий вызов в MoveNext или Reset вызывает InvalidOperationException. Если коллекция изменяется между вызовами MoveNext и Current, Current возвращает элемент, на который она настроена, даже если переписчик был аналирован.