IRemoteArgumentEnumeratorContract Schnittstelle

Definition

Namespace:

System.AddIn.Contract.Collections

Assembly:

System.AddIn.Contract.dll

Listet die Elemente einer Auflistung von RemoteArgument-Objekten auf.

public interface class IRemoteArgumentEnumeratorContract : System::AddIn::Contract::IContract

public interface IRemoteArgumentEnumeratorContract : System.AddIn.Contract.IContract

type IRemoteArgumentEnumeratorContract = interface
    interface IContract

Public Interface IRemoteArgumentEnumeratorContract
Implements IContract

Abgeleitet

System.AddIn.Contract.Collections.IRemoteArgumentDictionaryEnumeratorContract

Implementiert

IContract

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 RemoteArgument 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)