IEnumeratorContract<C> Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Listet die Elemente einer generischen Auflistung von IContract-Objekten auf.
generic <typename C>
where C : IContractpublic interface class IEnumeratorContract : System::AddIn::Contract::IContract
public interface IEnumeratorContract<C> : System.AddIn.Contract.IContract where C : IContract
type IEnumeratorContract<'C (requires 'C :> IContract)> = interface
interface IContract
Public Interface IEnumeratorContract(Of C)
Implements IContract
Typparameter
- C
Der Typ der aufzulistenden Objekte. C
muss die IContract-Schnittstelle implementieren.
- Implementiert
Hinweise
Mit Enumeratoren können die Daten in der Auflistung zwar gelesen, jedoch nicht zum Ändern der zugrunde liegenden Auflistung verwendet werden.
Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert. An dieser Position ist der Rückgabewert von GetCurrent undefiniert. Daher müssen Sie aufrufen MoveNext , um den Enumerator auf das erste Element der Auflistung vor dem Aufrufen GetCurrentvon zu weiterentwickeln.
GetCurrent gibt solange dasselbe Objekt zurück, bis MoveNext aufgerufen wird. MoveNext legt den Rückgabewert von GetCurrent auf das nächste Element fest.
Wenn MoveNext das Ende der Auflistung übergibt, wird der Enumerator hinter dem letzten Element in der Auflistung platziert, und MoveNext gibt false
zurück. Wenn sich der Enumerator an dieser Position befindet, geben nachfolgende Aufrufe von MoveNext auch false
zurück. Wenn der letzte Aufruf von MoveNext zurückgegeben wird false
, ist der Rückgabewert von GetCurrent undefiniert.
Ein Enumerator bleibt gültig, solange die Auflistung unverändert bleibt. Werden an der Auflistung Änderungen wie z. B. Hinzufügen, Bearbeiten oder Entfernen von Elementen vorgenommen, verliert der Enumerator unwiederbringlich seine Gültigkeit und sein Verhalten ist nicht definiert.
Methoden
AcquireLifetimeToken() |
Gibt an, dass ein Client auf den Vertrag zugreifen kann, bis der Client den Vertrag widerruft. (Geerbt von IContract) |
GetCurrent() |
Gibt den IContract in der Auflistung an der aktuellen Position des Enumerators zurück. |
GetRemoteHashCode() |
Gibt einen Hashcode für den IContract zurück. (Geerbt von IContract) |
MoveNext() |
Setzt den Enumerator auf das nächste Element der Auflistung. |
QueryContract(String) |
Gibt einen Vertrag zurück, der von diesem Vertrag implementiert wird. (Geerbt von IContract) |
RemoteEquals(IContract) |
Gibt an, ob der angegebene Vertrag mit diesem IContract identisch ist. (Geerbt von IContract) |
RemoteToString() |
Gibt eine Zeichenfolgenentsprechung der aktuellen IContract zurück. (Geerbt von IContract) |
Reset() |
Setzt den Enumerator auf seine anfängliche Position vor dem ersten Element in der Auflistung. |
RevokeLifetimeToken(Int32) |
Gibt an, dass ein Client nicht mehr auf den Vertrag zugreifen kann. (Geerbt von IContract) |