ControlCollection.AddContentControl (Método) (ContentControl, String)
Agrega un nuevo control ContentControl basado en un control de contenido nativo del documento.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function AddContentControl ( _
contentControl As ContentControl, _
name As String _
) As ContentControl
ContentControl AddContentControl(
ContentControl contentControl,
string name
)
Parámetros
- contentControl
Tipo: Microsoft.Office.Interop.Word.ContentControl
Microsoft.Office.Interop.Word.ContentControl que es la base del nuevo control.
- name
Tipo: System.String
Nombre del nuevo control.
Valor devuelto
Tipo: Microsoft.Office.Tools.Word.ContentControl
El control ContentControl que se agregó al documento.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | El valor de contentControl es nullreferencia null (Nothing en Visual Basic). O bien name es nullreferencia null (Nothing en Visual Basic) o tiene longitud cero. |
| ControlNameAlreadyExistsException | Ya existe un control con el mismo nombre en ControlCollection. |
| ArgumentException | contentControl no es una galería de bloques de creación (es decir, la propiedad Microsoft.Office.Interop.Word.ContentControl.Type de contentControl no tiene el valor Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText). |
Comentarios
Utilice este método para agregar un nuevo control ContentControl basado en un control de contenido nativo del documento en tiempo de ejecución. Esto resulta útil si crea un control ContentControl en tiempo de ejecución y desea volver a crear el mismo control la próxima vez que se abra el documento. Para obtener más información, vea Agregar controles a documentos de Office en tiempo de ejecución.
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.