CachedDataHostItemEnumerator – třída

Prochází CachedDataHostItemCollection.

Hierarchie dědičnosti

System.Object
  Microsoft.VisualStudio.Tools.Applications.CachedDataHostItemEnumerator

Obor názvů:  Microsoft.VisualStudio.Tools.Applications
Sestavení:  Microsoft.VisualStudio.Tools.Applications.ServerDocument (v Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Syntaxe

'Deklarace
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class CachedDataHostItemEnumerator _
    Implements IEnumerator(Of CachedDataHostItem), IDisposable,  _
    IEnumerator

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class CachedDataHostItemEnumerator : IEnumerator<CachedDataHostItem>, 
    IDisposable, IEnumerator

Typ CachedDataHostItemEnumerator zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Current	Získává CachedDataHostItem aktuální pozice čítače výčtu.

Nahoru

Metody

	Název	Popis
	Equals	Určuje, zda zadaný objekt je rovno aktuální objekt. (Zděděno z Object.)
	GetHashCode	Slouží jako funkci hash u určitého typu. (Zděděno z Object.)
	GetType	Získá Type aktuální instance. (Zděděno z Object.)
	MoveNext	Přejde na další čítače výčtu CachedDataHostItem v CachedDataHostItemCollection.
	Reset	Nastaví čítač do výchozí polohy, která je před první CachedDataHostItem v kolekci.
	ToString	Vrátí řetězec, který představuje aktuální objekt. (Zděděno z Object.)

Nahoru

Explicitní implementace rozhraní

	Název	Popis
	IEnumerator.Current	Popis tohoto člena v Current.
	IDisposable.Dispose	Uvolní všechny prostředky používané CachedDataHostItemEnumerator.

Nahoru

Poznámky

Visual Basic a C# obsahují prohlášení, že skryje složitost výčtu (foreach v jazyce C# a For Each v jazyce Visual Basic). Použijte odpovídající příkaz jazyka, který používáte, namísto přímé zpracovávání čítače výčtu.

Výčtu lze číst data v kolekci, ale není možné změnit základní kolekce.

Zpočátku je čítač umístěn před první element v kolekci. Reset Metoda přináší také čítače výčtu zpět do tohoto umístění. Na této pozici, nastavení Current vlastnost výjimku. Proto je třeba volat MoveNext metodu čítač na první prvek kolekce před čtení hodnoty Current.

Currentvrátí stejný objekt, dokud buď MoveNext nebo Reset se nazývá. MoveNextNastaví Current na další prvek.

Pokud MoveNext průchodů konec kolekci čítače výčtu je umístěn za poslední prvek v kolekci a MoveNext vrátí false. Pokud čítač je na této pozici následných výzev k MoveNext také vrátit false. Poslední volání na MoveNext vrátil false, volající Current výjimku. Nastavit Current na první prvek kolekce znovu zavolat Reset a MoveNext.

Čítač zůstává platný tak dlouho, dokud kolekce zůstane beze změny. Pokud změny kolekce, například přidávání, úpravy nebo odstranění prvků čítače výčtu je nenávratně zrušena a další volání na MoveNext nebo Reset vyvolá InvalidOperationException. Pokud je kolekce změněny mezi MoveNext a Current, Current vrátí prvek, který je nastaven, přestože čítač již zrušena.

Čítač nemá výhradní přístup ke kolekci. Proto výčet prostřednictvím kolekce není bezpečný pro přístup z více vláken. I když kolekce synchronizována, jiných podprocesů upravovat kolekce, která způsobí, že čítače výčtu k vyvolání výjimky. Pro zajištění bezpečnosti podprocesu během výčtu lze uzamknout kolekce během celého výčtu nebo zachytit výjimky vyplývající ze změny provedené v jiných podprocesů.

Bezpečný přístup z více vláken

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.

Viz také

Referenční dokumentace

Microsoft.VisualStudio.Tools.Applications – obor názvů