ControlCollection.AddContentControl - метод (ContentControl, String)
Добавляет новый элемент управления ContentControl, основанный на собственном элементе управления содержимым в документе.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)
Синтаксис
'Декларация
Function AddContentControl ( _
contentControl As ContentControl, _
name As String _
) As ContentControl
ContentControl AddContentControl(
ContentControl contentControl,
string name
)
Параметры
- contentControl
Тип: Microsoft.Office.Interop.Word.ContentControl
Элемент управления Microsoft.Office.Interop.Word.ContentControl, служащий основой для нового элемента управления.
- name
Тип: System.String
Имя нового элемента управления.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Word.ContentControl
Элемент управления ContentControl, добавленный в документ.
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Параметр contentControl имеет значение nullпустая ссылка (Nothing в Visual Basic). – или – Параметр name имеет значение nullпустая ссылка (Nothing в Visual Basic) или нулевую длину. |
| ControlNameAlreadyExistsException | Элемент управления с таким именем уже имеется в данном экземпляре коллекции ControlCollection. |
| ArgumentException | Параметр contentControl не является коллекцией стандартных блоков (это значит, что свойству Microsoft.Office.Interop.Word.ContentControl.Type объекта contentControl не присвоено значение Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText). |
Заметки
Этот метод используется для добавления во время выполнения нового элемента управления ContentControl, основанного на исходном элементе управления содержимым в документе. Это полезно при создании элемента управления ContentControl во время выполнения, если необходимо повторно создать такой же элемент управления при следующем открытии документа. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.