Класи колекцій Web-Extension

Класи колекцій веб-розширень

У цьому посібнику показано, як чотири класи колекцій веб-розширень у Aspose.Words FOSS для .NET — TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection, і WebExtensionReferenceCollection — діляться єдиним контрактом колекції через абстрактний BaseWebExtensionCollection базовий клас. Щоб дізнатися, що насправді представляють панелі завдань, прив’язки та властивості веб-розширень, перегляньте Web Extensions посібник; ця сторінка охоплює лише контейнер API, яким вони всі користуються.

BaseWebExtensionCollection: Один контракт, чотири колекції

BaseWebExtensionCollection є базовим класом для TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection і WebExtensionReferenceCollection. Він реалізує IEnumerable<T> і визначає кожен член, який ці чотири конкретні колекції розкривають — жоден із чотирьох підкласів не оголошує додаткових методів або властивостей, окрім того, що надає базовий клас.

Додавання, видалення та підрахунок елементів

Add(item) додає вказаний елемент до колекції. Clear() видаляє всі елементи. Remove(index) видаляє елемент за вказаним індексом — він приймає позиційний index, а не посилання на елемент, тому видалення конкретного елемента означає спочатку знайти його індекс. Count повідомляє кількість елементів, які наразі знаходяться в колекції.

Перерахування колекції

GetEnumerator() повертає перечислювач, який може ітерувати колекцію, тому будь-яка колекція, успадкована від BaseWebExtensionCollection, підтримує цикл foreach над її елементами без коду ітерації, специфічного для типу.

Поради та найкращі практики

• Оскільки всі чотири колекції ділять один і той самий базовий контракт, код, написаний проти BaseWebExtensionCollection’s Add, Clear, Remove, Count і GetEnumerator членів, працює однаково у TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection і WebExtensionReferenceCollection.
• Remove(index) приймає позиційний індекс — якщо у вас є лише сам елемент, спочатку перелічіть колекцію, щоб знайти його індекс, або відстежуйте індекс під час вставки.
• Прочитайте Count перед ітерацією, або foreach колекцію безпосередньо за допомогою GetEnumerator(), замість ручного індексування, оскільки базовий контракт не надає позиційного геттера.
• Викликайте Clear(), коли потрібно скинути колекцію, замість того, щоб багаторазово викликати Remove у циклі.

Типові проблеми

FAQ

Чому чотири колекції веб-розширень поводяться однаково?

Всі вони успадковуються від одного й того ж абстрактного базового класу BaseWebExtensionCollection, який визначає Add, Clear, Remove, Count та GetEnumerator — жоден з чотирьох підкласів не додає власних членів.

Як видалити конкретний елемент з одної з цих колекцій?

Викличте Remove(index) з позиційним індексом елемента — спочатку знайдіть індекс, перебравши колекцію, якщо у вас є лише посилання на елемент.

Чи можу я ітерувати будь-яку з цих чотирьох колекцій однаковим способом?

Так — усі чотири реалізують IEnumerable<T> через BaseWebExtensionCollection, тому GetEnumerator() / foreach працює однаково у всіх них.

Де я можу дізнатися, що саме представляє елемент WebExtensionBinding або TaskPane?

Дивіться Web Extensions посібник — ця сторінка охоплює лише поведінку спільного контейнера колекції, а не доменні об’єкти, які містяться в колекціях.

API Reference Підсумок

Дивіться також

• Aspose.Words for .NET — Enterprise Documentation