Método ControlCollection.AddContentControl (ContentControl, String)
Adiciona um novo ContentControl que é baseado em um controle de conteúdo nativo no documento.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
Sintaxe
'Declaração
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 é a base para o novo controle.
- name
Tipo: System.String
O nome do novo controle.
Valor de retorno
Tipo: Microsoft.Office.Tools.Word.ContentControl
ContentControl que foi adicionado ao documento.
Exceções
| Exceção | Condição |
|---|---|
| ArgumentNullException | contentControl é nulluma referência nula (Nothing no Visual Basic). - ou - name é nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero. |
| ControlNameAlreadyExistsException | Um controle com o mesmo nome já está em ControlCollection. |
| ArgumentException | contentControl não é uma galeria do bloco de construção (ou seja, a propriedade de Microsoft.Office.Interop.Word.ContentControl.Type de contentControl não tem o valor Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText). |
Comentários
Use este método para adicionar novo ContentControl que é baseado em um controle de conteúdo nativo no documento em tempo de execução. Isso é útil quando você cria ContentControl em tempo de execução, e você deseja recriar o mesmo controle na próxima vez que o documento está aberto. Para obter mais informações, consulte Adicionando controles a documentos do Office em tempo de execução.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.