IVector<T> Antarmuka

Referensi

Definisi

Ruang nama:: Windows.Foundation.Collections

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili kumpulan elemen akses acak.

.BERSIH Antarmuka ini tampaknya kode .NET sebagai System.Collections.Generic.IList<T> karena proyeksi bahasa .NET. Dalam kasus apa pun di mana jenis Windows Runtime telah menerapkan IVector<T>, kode .NET dapat menggunakan API IList<T> sebagai gantinya.

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)

Jenis parameter

T

Atribut: ContractVersionAttribute GuidAttribute

Penerapan: IIterable<T> IEnumerable<T>

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (diperkenalkan dalam v1.0)

Keterangan

Saat pemrograman dengan .NET, antarmuka ini tersembunyi dan pengembang harus menggunakan antarmuka System.Collections.Generic.IList<T> jika mereka ingin menerapkan jenis vektor/daftar. Dalam kasus apa pun di mana jenis Windows Runtime telah menerapkan IVector<T>, kode .NET dapat menggunakan API IList<T> sebagai gantinya. Ini termasuk semua WINDOWS Runtime API yang ada dan juga skenario seperti menggunakan API komponen Windows Runtime yang awalnya diterapkan dalam ekstensi komponen Visual C++ (C++/CX) dari aplikasi C# atau Visual Basic.

Antarmuka IVector<T> mewakili kumpulan objek dari jenis tertentu yang dapat diakses secara individual oleh indeks. Properti dan metode IVector<T> mendukung fungsionalitas jenis daftar, seperti mendapatkan ukuran koleksi, dan menambahkan dan menghapus item di lokasi tertentu dalam koleksi. Selain itu, metode GetView menyediakan rekam jepret vektor yang statusnya dapat diamati tidak berubah. Rekam jepret berguna ketika Anda memerlukan tampilan koleksi untuk dirujuk dalam operasi berikutnya yang melibatkan IVector<T>.

Fungsi ekstensi C++/WinRT

Catatan

Fungsi ekstensi ada pada jenis proyeksi C++/WinRT untuk API Windows Runtime tertentu. Misalnya, winrt::Windows::Foundation::IAsyncAction adalah jenis proyeksi C++/WinRT untuk IAsyncAction. Fungsi ekstensi bukan bagian dari permukaan antarmuka biner aplikasi (ABI) dari jenis Windows Runtime yang sebenarnya, sehingga tidak terdaftar sebagai anggota API Windows Runtime. Tetapi Anda dapat memanggilnya dari dalam proyek C++/WinRT apa pun. Lihat fungsi C++/WinRT yang memperluas WINDOWS Runtime API.

auto begin() const;

Mengembalikan iterator ke elemen pertama koleksi, untuk digunakan dalam algoritma C++ seperti perulangan berbasis for rentang.

auto end() const;

Mengembalikan iterator ke satu melewati elemen terakhir koleksi, untuk digunakan dalam algoritma C++ seperti perulangan berbasis for rentang.

Pewarisan antarmuka

IVector mewarisi IIterable. Jenis yang mengimplementasikan IVector juga mengimplementasikan anggota antarmuka IIterable. Demikian pula, jika Anda menggunakan .NET, ada dukungan untuk IEnumerable<T>.

Properti

Size	Mendapatkan jumlah item di vektor.

Metode

Append(T)	Menambahkan item ke akhir vektor.
Clear()	Menghapus semua item dari vektor.
GetAt(UInt32)	Mengembalikan item pada indeks yang ditentukan dalam vektor.
GetMany(UInt32, T[])	Mengambil beberapa item dari vektor yang dimulai pada indeks yang diberikan. C++/WinRT Sintaks yang benar untuk proyeksi bahasa C++/WinRT adalah `uint32_t GetMany(uint32_t startIndex, winrt::array_view<T> items);`.
GetView()	Mengembalikan tampilan vektor yang tidak dapat diubah.
IndexOf(T, UInt32)	Mengambil indeks item tertentu dalam vektor.
InsertAt(UInt32, T)	Menyisipkan item pada indeks tertentu dalam vektor.
RemoveAt(UInt32)	Menghapus item pada indeks yang ditentukan di vektor.
RemoveAtEnd()	Menghapus item terakhir dari vektor.
ReplaceAll(T[])	Mengganti semua item dalam vektor dengan item yang ditentukan.
SetAt(UInt32, T)	Mengatur nilai pada indeks yang ditentukan dalam vektor.

Berlaku untuk