ControlCollection.AddContentControl Метод (ContentControl, String) (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Добавляет новый элемент управления ContentControl, основанный на исходном элементе управления содержимым в документе.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Function AddContentControl ( _
    contentControl As ContentControl, _
    name As String _
) As ContentControl
'Применение
Dim instance As ControlCollection
Dim contentControl As ContentControl
Dim name As String
Dim returnValue As ContentControl

returnValue = instance.AddContentControl(contentControl, _
    name)

public 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ссылка null (Nothing в Visual Basic). –или– Параметр name имеет значение nullссылка null (Nothing в Visual Basic) или нулевую длину.
ControlNameAlreadyExistsException	Элемент управления с таким именем уже имеется в данном экземпляре коллекции ControlCollection.
ArgumentException	Параметр contentControl не является коллекцией стандартных блоков (это значит, что свойству Microsoft.Office.Interop.Word.ContentControl.Type объекта contentControl не присвоено значение Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText).

ArgumentNullException

Значение параметра contentControl равно nullссылка null (Nothing в Visual Basic).

–или–

Параметр name имеет значение nullссылка null (Nothing в Visual Basic) или нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже имеется в данном экземпляре коллекции ControlCollection.

ArgumentException

Параметр contentControl не является коллекцией стандартных блоков (это значит, что свойству Microsoft.Office.Interop.Word.ContentControl.Type объекта contentControl не присвоено значение Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText).

Заметки

Этот метод используется для добавления во время выполнения нового элемента управления ContentControl, основанного на исходном элементе управления содержимым в документе. Это полезно при создании элемента управления ContentControl во время выполнения, если необходимо повторно создать такой же элемент управления при следующем открытии документа. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.