ControlCollection.AddContentControl, méthode (ContentControl, String)
Ajoute un nouveau ContentControl basé sur un contrôle de contenu natif dans le document.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)
Syntaxe
'Déclaration
Function AddContentControl ( _
contentControl As ContentControl, _
name As String _
) As ContentControl
ContentControl AddContentControl(
ContentControl contentControl,
string name
)
Paramètres
- contentControl
Type : Microsoft.Office.Interop.Word.ContentControl
Microsoft.Office.Interop.Word.ContentControl qui est la base du nouveau contrôle.
- name
Type : System.String
Nom du nouveau contrôle.
Valeur de retour
Type : Microsoft.Office.Tools.Word.ContentControl
ContentControl ajouté au document.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | contentControl a la valeur nullune référence null (Nothing en Visual Basic). ou name est nullune référence null (Nothing en Visual Basic) ou une longueur nulle. |
| ControlNameAlreadyExistsException | Un contrôle du même nom figure déjà dans ControlCollection. |
| ArgumentException | contentControl n'est pas une galerie de blocs de construction (à savoir la propriété Microsoft.Office.Interop.Word.ContentControl.Type de contentControl n'a pas la valeur Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText). |
Notes
Utilisez cette méthode pour ajouter un nouveau ContentControl basé sur un contrôle de contenu natif dans le document au moment de l'exécution.Cela est utile lorsque vous créez un ContentControl au moment de l'exécution et que vous souhaitez recréer le même contrôle lors de la prochaine ouverture du document.Pour plus d'informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.