Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Добавляет элемент в объект Collection .
Синтаксис
object. Добавлениеэлемента, ключа, до, после
В синтаксисе метода Add используются следующие квалификатор объекта и именованные аргументы:
| Part | Описание |
|---|---|
| object | Обязательно. Выражение объекта, которое вычисляет объект в списке Применимо к. |
| элемента | Обязательно. Выражение любого типа, определяющее элемент, который требуется добавить в коллекцию. |
| key | Необязательный параметр. Уникальное строковое выражение, задающее строку ключа, которая может использоваться вместо индекса позиции для доступа к элементу коллекции. |
| Перед | Необязательный параметр. Выражение, определяющее относительную позицию в коллекции. Добавляемый элемент помещается в коллекцию перед элементом, определяемым аргументомbefore. Если числовое выражение, параметр before должен быть числом от 1 до значения свойства Count коллекции. Если это строковое выражение, то аргумент before должен соответствовать значению key, указанному при добавлении в коллекцию элемента, на который определена ссылка. Допускается задавать позицию либо с помощью аргумента before, либо с помощью after, но не одновременно обоих аргументов. |
| После | Необязательный параметр. Выражение, определяющее относительную позицию в коллекции. Добавляемый элемент помещается в позицию после элемента, определяемого аргументом after. Если это числовое выражение, то аргумент after должен быть числом в диапазоне от 1 до значения свойства Count коллекции. Если это строковое выражение, то аргумент after должен соответствовать значению key, указанному при добавлении в коллекцию элемента, на который определена ссылка. Допускается задавать позицию либо с помощью аргумента before, либо с помощью after, но не одновременно обоих аргументов. |
Примечания
Независимо от того, является аргумент before или after строковым или числовым выражением, он должен ссылаться на существующий элемент коллекции. В противном случае происходит ошибка.
Также ошибка возникает в том случае, если заданный аргумент key повторяет значение аргумента key для существующего элемента коллекции.
Пример
В этом примере метод Add используется для добавления строк в коллекцию с ключом и без нее. Метод Item используется неявно для получения каждой строки.
Dim c As Collection
Set c = New Collection
c.Add "a"
c.Add "c", "CC"
c.Add "b", "BB", 2
c.Add "d"
Debug.Print c(1) ' --> prints "a"
Debug.Print c(2) ' --> prints "b"
Debug.Print c(3) ' --> prints "c"
Debug.Print c("BB") ' --> prints "b"
Debug.Print c("d") ' --> error (no key was specified for this element - a positional index must be used)
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.