IIterable<T> Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Expõe um iterador que dá suporte à iteração simples em uma coleção de um tipo especificado.
.NET Essa interface aparece como System.Collections.Generic.IEnumerable<T>. Em qualquer caso em que um tipo de Windows Runtime implementou IIterable<T>, o código .NET pode usar as APIs de IEnumerable<T>. O código C# pode usar foreach, o código do Visual Basic pode usar For Each... Em seguida. Todos os métodos de extensão do .NET baseados em IEnumerable<T> e incluídos no .NET para aplicativos UWP são acessíveis (incluindo as extensões System.Linq , desde que você tenha incluído o namespace).
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)Parâmetros de tipo
- T
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.FoundationContract (introduzida na v1.0)
|
Comentários
Ao programar com o .NET, essa interface fica oculta e os desenvolvedores devem usar a interface System.Collections.Generic.IEnumerable<T> . Devido à forma como as projeções foram feitas, o método GetEnumerator nem sempre está disponível como um método callable direto nos tipos que projetam IEnumerable<T> conforme implementado, mas ainda há suporte para a enumeração da coleção com a sintaxe de enumeração padrão (foreach). O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator de uma classe, converta para IEnumerab<T>, usando uma restrição na conversão que corresponda ao tipo de item da coleção.
Funções de extensão C++/WinRT
Observação
Existem funções de extensão nos tipos de projeção C++/WinRT para determinadas APIs Windows Runtime. Por exemplo, winrt::Windows::Foundation::IAsyncAction é o tipo de projeção C++/WinRT para IAsyncAction. As funções de extensão não fazem parte da superfície da ABI (interface binária do aplicativo) dos tipos de Windows Runtime reais, portanto, não são listadas como membros das APIs Windows Runtime. Mas você pode chamá-los de dentro de qualquer projeto C++/WinRT. Confira Funções do C++/WinRT que estendem apIs de Windows Runtime.
auto begin() const;
Retorna um iterador para o primeiro elemento da coleção, para uso em algoritmos C++, como loops baseados em for intervalo.
auto end() const;
Retorna um iterador para um após o último elemento da coleção, para uso em algoritmos C++, como loops baseados em for intervalo.
Métodos
| First() |
Retorna um iterador para os itens na coleção. |