ControlCollection.AddContentControl-Methode (ContentControl, String)
Fügt ein neues ContentControl-Element hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Syntax
'Declaration
Function AddContentControl ( _
contentControl As ContentControl, _
name As String _
) As ContentControl
ContentControl AddContentControl(
ContentControl contentControl,
string name
)
Parameter
- contentControl
Typ: Microsoft.Office.Interop.Word.ContentControl
Das Microsoft.Office.Interop.Word.ContentControl, das die Grundlage für das neue Steuerelement darstellt.
- name
Typ: System.String
Der Name des neuen Steuerelements.
Rückgabewert
Typ: Microsoft.Office.Tools.Word.ContentControl
Das ContentControl, das dem Dokument hinzugefügt wurde.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | contentControl hat den Wert nullNULL-Verweis (Nothing in Visual Basic). – oder – name ist nullNULL-Verweis (Nothing in Visual Basic) oder hat die Länge 0 (null). |
| ControlNameAlreadyExistsException | Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection vorhanden. |
| ArgumentException | contentControl ist kein Bausteinkatalog (d. h., die Microsoft.Office.Interop.Word.ContentControl.Type-Eigenschaft von contentControl hat nicht den Wert Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText). |
Hinweise
Verwenden Sie diese Methode, um zur Laufzeit ein neues ContentControl hinzuzufügen, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert. Diese Vorgehensweise ist hilfreich, wenn Sie ein ContentControl zur Laufzeit erstellen und das gleiche Steuerelement beim nächsten Öffnen des Dokuments neu erstellen möchten. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.