IIterable<T> 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.
Macht einen Iterator verfügbar, der eine einfache Iteration über eine Auflistung eines angegebenen Typs unterstützt.
.NETTO Diese Schnittstelle wird als System.Collections.Generic.IEnumerable<T> angezeigt. In jedem Fall, wenn ein Windows-Runtime Typ IIterable<T> implementiert hat, kann .NET-Code stattdessen die APIs von IEnumerable<T> verwenden. C#-Code kann foreach verwenden, Visual Basic-Code kann For Each verwenden... Als Nächstes. Alle .NET-Erweiterungsmethoden, die auf IEnumerable<T> basieren und in .NET für UWP-Apps enthalten sind, sind zugänglich (einschließlich der System.Linq-Erweiterungen , sofern Sie den Namespace eingeschlossen haben).
public interface class IIterable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(4205151722, 25108, 16919, 175, 218, 127, 70, 222, 88, 105, 179)]
template <typename T>
struct IIterable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(4205151722, 25108, 16919, 175, 218, 127, 70, 222, 88, 105, 179)]
public interface IEnumerable<T>Public Interface IEnumerable(Of T)Typparameter
- T
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.FoundationContract (eingeführt in v1.0)
|
Hinweise
Bei der Programmierung mit .NET ist diese Schnittstelle ausgeblendet, und Entwickler sollten die System.Collections.Generic.IEnumerable<T-Schnittstelle> verwenden. Aufgrund der Art und Weise, wie die Projektionen durchgeführt wurden, ist die GetEnumerator-Methode nicht immer als direkte aufrufbare Methode für die Typen verfügbar, die IEnumerable<T> als implementiert haben, aber das Aufzählen der Auflistung mit der Standardenumerationssyntax (foreach) wird weiterhin unterstützt. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aus einer Klasse aufrufen möchten, werden Sie in IEnumerab<T> umgewandelt, indem Sie eine Einschränkung in der Umwandlung verwenden, die dem Elementtyp der Auflistung entspricht.
C++/WinRT-Erweiterungsfunktionen
Hinweis
Erweiterungsfunktionen sind für die C++/WinRT-Projektionstypen für bestimmte Windows-Runtime APIs vorhanden. Beispielsweise ist winrt::Windows::Foundation::IAsyncAction der C++/WinRT-Projektionstyp für IAsyncAction. Die Erweiterungsfunktionen sind nicht Teil der ABI-Oberfläche (Application Binary Interface) der tatsächlichen Windows-Runtime-Typen, sodass sie nicht als Member der Windows-Runtime-APIs aufgeführt werden. Sie können sie jedoch innerhalb eines beliebigen C++/WinRT-Projekts aufrufen. Weitere Informationen finden Sie unter C++/WinRT-Funktionen, die Windows-Runtime-APIs erweitern.
auto begin() const;
Gibt einen Iterator für das erste Element der Auflistung zur Verwendung in C++-Algorithmen zurück, z. B. bereichsbasierte for Schleifen.
auto end() const;
Gibt einen Iterator nach dem letzten Element der Auflistung zur Verwendung in C++-Algorithmen zurück, z. B. bereichsbasierte for Schleifen.
Methoden
| First() |
Gibt einen Iterator für die Elemente in der Auflistung zurück. |