Metodo ControlCollection.AddContentControl (ContentControl, String)
Aggiunge un nuovo oggetto ContentControl basato su un controllo del contenuto nativo presente nel documento.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Sintassi
'Dichiarazione
Function AddContentControl ( _
contentControl As ContentControl, _
name As String _
) As ContentControl
ContentControl AddContentControl(
ContentControl contentControl,
string name
)
Parametri
- contentControl
Tipo: Microsoft.Office.Interop.Word.ContentControl
Oggetto Microsoft.Office.Interop.Word.ContentControl alla base del nuovo controllo.
- name
Tipo: System.String
Nome del nuovo controllo.
Valore restituito
Tipo: Microsoft.Office.Tools.Word.ContentControl
Oggetto ContentControl aggiunto al documento.
Eccezioni
| Eccezione | Condizione |
|---|---|
| ArgumentNullException | contentControl è nullriferimento null (Nothing in Visual Basic). In alternativa name è nullriferimento null (Nothing in Visual Basic) oppure ha lunghezza zero. |
| ControlNameAlreadyExistsException | In ControlCollection è già presente un controllo con lo stesso nome. |
| ArgumentException | contentControl non è una raccolta di blocchi predefiniti, vale a dire che la proprietà Microsoft.Office.Interop.Word.ContentControl.Type di contentControl non ha il valore Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText. |
Note
Utilizzare questo metodo per aggiungere un nuovo oggetto ContentControl basato su un controllo contenuto nativo presente nel documento in fase di esecuzione. Questa operazione si rivela utile quando, nella creazione di un oggetto ContentControl in fase di esecuzione, si desidera ricreare lo stesso controllo alla successiva apertura del documento. Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.