BreakpointTargetEnumerator.Current Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает текущий объект BreakpointTarget в коллекции.
public:
property Microsoft::SqlServer::Dts::Runtime::BreakpointTarget ^ Current { Microsoft::SqlServer::Dts::Runtime::BreakpointTarget ^ get(); };
public Microsoft.SqlServer.Dts.Runtime.BreakpointTarget Current { get; }
member this.Current : Microsoft.SqlServer.Dts.Runtime.BreakpointTarget
Public ReadOnly Property Current As BreakpointTarget
Значение свойства
Текущий объект BreakpointTarget в коллекции.
Примеры
В следующем примере кода создается перечислитель, а затем используются Current методы для MoveNext
перемещения по коллекции.
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;
namespace BreakpointTarget_Expression
{
class Program
{
static void Main(string[] args)
{
Package pkg = new Package();
TaskHost taskHost = (TaskHost)pkg.Executables.Add("STOCK:FileSystemTask");
BreakpointTargets bptargets = pkg.GetBreakpointTargets(taskHost, false);
// Create the enumerator.
BreakpointTargetEnumerator myEnumerator = bptargets.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.BulkInsertTask
Namespace BreakpointTarget_Expression
Class Program
Shared Sub Main(ByVal args() As String)
Dim pkg As Package = New Package()
Dim taskHost As TaskHost = CType(pkg.Executables.Add("STOCK:FileSystemTask"), TaskHost)
Dim bptargets As BreakpointTargets = pkg.GetBreakpointTargets(taskHost,False)
' Create the enumerator.
Dim myEnumerator As BreakpointTargetEnumerator = bptargets.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
Образец вывода:
Коллекция содержит следующие значения:
[0] Прерывание при получении контейнера события OnPreExecute
[1] Прерывание при получении контейнера события OnPostExecute
[2] Прерывание, когда контейнер получает событие OnError
[3] Прерывание при получении контейнером события OnWarning
[4] Прерывание при получении контейнера события OnInformation
[5] Прерывание при получении контейнера события OnTaskFailed
[6] Прерывание при получении контейнера события OnProgress
[7] Прерывание при получении контейнера события OnQueryCancel
[8] Прерывание при получении контейнера события OnVariableValueChanged
[9] Прерывание при получении контейнера события OnCustomEvent
Комментарии
После создания перечислителя или после вызова Reset
метода необходимо вызвать метод для MoveNext
продвижения перечислителя к первому элементу коллекции перед чтением значения Current свойства; Current в противном случае он неизвестен и вызывает исключение.
CurrentТакже вызывает исключение, если последний вызов возвращенного false
, MoveNext
который указывает конец коллекции.
Current не перемещает позицию перечислителя и последовательные вызовы для Current возврата одного и того же объекта до вызова или MoveNext
Reset
вызова.
Перечислитель является допустимым до тех пор, пока коллекция остается неизменной. Если в коллекцию вносятся изменения, такие как добавление, изменение или удаление элементов, перечислитель является недействительным и неустранимым, поэтому следующий вызов MoveNext
или Reset
создает исключение InvalidOperationException
. Если коллекция изменяется между MoveNext
и Currentвозвращает Current заданный элемент, даже если перечислитель уже недопустим.