Point3DCollection.GetEnumerator Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Returnerar en uppräknare som kan iterera genom samlingen.
public:
System::Windows::Media::Media3D::Point3DCollection::Enumerator GetEnumerator();
public System.Windows.Media.Media3D.Point3DCollection.Enumerator GetEnumerator();
member this.GetEnumerator : unit -> System.Windows.Media.Media3D.Point3DCollection.Enumerator
Public Function GetEnumerator () As Point3DCollection.Enumerator
Returer
En uppräkning som kan iterera genom samlingen.
Kommentarer
Uppräknare tillåter endast läsning av data i samlingen. Uppräknare kan inte användas för att ändra den underliggande samlingen.
Från början placeras uppräknaren före det första objektet i samlingen. I det här läget utlöser anrop Current ett undantag. Därför måste du anropa MoveNext för att flytta uppräknaren till det första objektet i samlingen innan du läser värdet för Aktuell.
Current returnerar samma objekt tills antingen MoveNext eller Reset anropas. MoveNext anger Aktuellt till nästa objekt.
När slutet av samlingen har skickats placeras uppräknaren efter det sista objektet i samlingen och anropet MoveNext returnerar false. Om det senaste anropet till MoveNext returnerade falskt utlöser anropet Current ett undantag. Om du vill ange Aktuell till det första objektet i samlingen igen kan du anropa Återställ följt av MoveNext.
En uppräkning förblir giltig så länge samlingen förblir oförändrad. Om ändringar görs i samlingen, till exempel att lägga till, ändra eller ta bort objekt, ogiltigförklaras uppräknaren oåterkalleligt och nästa anrop till MoveNext eller Reset genererar en InvalidOperationException. Om samlingen ändras mellan MoveNext och Current returnerar Current det objekt som den är inställd på, även om uppräknaren redan är ogiltig.
Uppräknaren har inte exklusiv åtkomst till samlingen. Därför är uppräkning genom en samling i sig inte en trådsäker procedur. Även när en samling synkroniseras kan andra trådar fortfarande ändra samlingen, vilket gör att uppräknaren genererar ett undantag. För att garantera trådsäkerheten under uppräkningen kan du antingen låsa samlingen under hela uppräkningen eller fånga undantagen från ändringar som gjorts av andra trådar.