ControlCollection.AddContentControl-Methode (ContentControl, String) (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Fügt ein neues ContentControl hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Syntax

'Declaration
Public Function AddContentControl ( _
    contentControl As ContentControl, _
    name As String _
) As ContentControl
'Usage
Dim instance As ControlCollection
Dim contentControl As ContentControl
Dim name As String
Dim returnValue As ContentControl

returnValue = instance.AddContentControl(contentControl, _
    name)

public 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).

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 hierzu finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Berechtigungen

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.