IVector<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.
Representa uma coleção de elementos de acesso aleatório.
.NET Essa interface aparece no código .NET como System.Collections.Generic.IList<T> devido à projeção de linguagem .NET. Em qualquer caso em que um tipo de Windows Runtime implementou o IVector<T>, o código .NET pode usar as APIs de IList<T>.
public interface class IVector : IIterable<T>/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
template <typename T>
struct IVector : IIterable<T>[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
public interface IList<T> : IEnumerable<T>Public Interface IList(Of T)
Implements IEnumerable(Of T)Parâmetros de tipo
- T
- Atributos
- Implementações
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.IList<T> se quiserem implementar um tipo de vetor/lista. Em qualquer caso em que um tipo de Windows Runtime implementou o IVector<T>, o código .NET pode usar as APIs de IList<T>. Isso inclui todas as API de Windows Runtime existentes e também cenários como o uso de APIs de componentes Windows Runtime originalmente implementados em extensões de componente do Visual C++ (C++/CX) de um aplicativo C# ou Visual Basic.
A interface IVector<T> representa uma coleção de objetos de um tipo especificado que podem ser acessados individualmente pelo índice. Propriedades e métodos do IVector<T> dão suporte à funcionalidade de tipo de lista, como obter o tamanho da coleção e adicionar e remover itens em locais especificados na coleção. Além disso, o método GetView fornece um instantâneo do vetor cujo estado observável não é alterado. O instantâneo é útil quando você precisa de uma exibição da coleção a ser referenciada em operações subsequentes que envolvem IVector<T>.
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.
Herança de interface
IVector herda IIterable. Os tipos que implementam o IVector também implementam os membros da interface IIterable. Da mesma forma, se você estiver usando o .NET, haverá suporte para IEnumerable<T>.
Propriedades
| Size |
Obtém o número de itens no vetor. |
Métodos
| Append(T) |
Acrescenta um item ao final do vetor. |
| Clear() |
Remove todos os itens do vetor. |
| GetAt(UInt32) |
Retorna o item no índice especificado no vetor. |
| GetMany(UInt32, T[]) |
Recupera vários itens do vetor começando no índice fornecido.
|
| GetView() |
Retorna uma exibição imutável do vetor. |
| IndexOf(T, UInt32) |
Recupera o índice de um item especificado no vetor. |
| InsertAt(UInt32, T) |
Insere um item em um índice especificado no vetor. |
| RemoveAt(UInt32) |
Remove o item no índice especificado no vetor. |
| RemoveAtEnd() |
Remove o último item do vetor. |
| ReplaceAll(T[]) |
Substitui todos os itens no vetor pelos itens especificados. |
| SetAt(UInt32, T) |
Define o valor no índice especificado no vetor. |