ContentLinkProviderCollection.GetMany(UInt32, ContentLinkProvider[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает несколько элементов за один проход через итератор.
public:
virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <ContentLinkProvider ^> ^ items) = IVector<ContentLinkProvider ^>::GetMany;
uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <ContentLinkProvider const&> & items);
public uint GetMany(uint startIndex, ContentLinkProvider[] items);
function getMany(startIndex, items)
Public Function GetMany (startIndex As UInteger, items As ContentLinkProvider()) As UInteger
Параметры
- startIndex
-
UInt32
unsigned int
uint32_t
Индекс, с которого начинается извлечение.
- items
- ContentLinkProvider[]
Предоставляет назначение для результата. Задайте размер исходного массива как "емкость", чтобы указать, сколько результатов необходимо извлечь.
Возвращаемое значение
Количество извлеченных элементов.
Реализации
1.GetMany(System.UInt32,
0[])
M:Windows.Foundation.Collections.IVector1.GetMany(unsigned int,
0[])
M:Windows.Foundation.Collections.IVector1.GetMany(uint32_t,
0[])
Комментарии
Важно!
Этот API поддерживает ссылки на содержимое. Функции Windows, которые включают ссылки на содержимое, недоступны в версиях Windows выше Windows 10 версии 1903. Ссылки на содержимое для текстовых элементов управления XAML не будут работать в версиях Windows выше 1903.
Метод GetMany работает так же, как при вызове и для каждого элемента в предоставленном массиве. Это означает, что первый элемент, возвращаемый методом GetMany, является тем же элементом, что и при извлечении свойства перед вызовом GetMany. После возврата вызова GetMany свойство извлекает элемент, следующий за последним элементом, возвращенным вызовом GetMany, или выдает ошибку, если в последовательностях больше нет элементов.
Метод GetMany возвращает фактическое количество возвращаемых элементов. Это должно быть минимальное значение a) количество элементов, оставшихся в коллекции, или б) количество запрошенных элементов, то есть "емкость". Таким образом, всякий раз, когда GetMany возвращает меньшее количество запрошенных элементов, достигается конец последовательности. Он возвращает количество элементов, извлеченных в выходном параметре "actual".
Если вызывающий объект задает нулевую емкость, положение итератора остается неизменным. Элементы массива, следующие за возвращаемыми значениями, не изменяются.