ContentControlContentUpdatingEventArgs.Content-Eigenschaft

Artikel
01/03/2014

Ruft den Text ab, der in das Inhaltssteuerelement des benutzerdefinierten XML-Abschnitts geschrieben wird, der an das Inhaltssteuerelement gebunden ist.

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

Syntax

'Declaration
Property Content As String

string Content { get; set; }

Eigenschaftswert

Typ: System.String
Der Text, der in das Inhaltssteuerelement des benutzerdefinierten XML-Abschnitts geschrieben wird, der an das Inhaltssteuerelement gebunden ist.

Hinweise

Sie können Inhaltssteuerelemente an ein Element in einem Teil von XML-Code (auch benutzerdefinierter XML-Abschnitt genannt) binden, der im Dokument eingebettet ist. Verwenden Sie die Content-Eigenschaft, um den Text zu ändern, bevor Microsoft Office Word das Steuerelement aktualisiert.

Weitere Informationen finden Sie unter Inhaltssteuerelemente und Übersicht über benutzerdefinierte XML-Abschnitte.

Beispiele

Im folgenden Codebeispiel werden Ereignishandler für das ContentUpdating-Ereignis und das StoreUpdating-Ereignis dargestellt. In diesem Beispiel wird davon ausgegangen, dass das Dokument ein PlainTextContentControl mit dem Namen plainTextContentControl1 enthält, das an ein Element in einem benutzerdefinierten XML-Abschnitt gebunden ist. Ein Codebeispiel, das die Bindung eines Inhaltssteuerelements an ein Element in einem benutzerdefinierten XML-Abschnitt veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Binden von Inhaltssteuerelementen an benutzerdefinierte XML-Abschnitte.

Wenn Sie diesen Code verwenden möchten, fügen Sie ihn in der ThisDocument-Klasse im Projekt ein. In C# müssen Sie außerdem die Ereignishandler an das ContentUpdating-Ereignis und das StoreUpdating-Ereignis von plainTextContentControl1 anfügen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene. Sie können es ändern, sodass es in einem Add-In auf Anwendungsebene ausgeführt wird. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Private Sub plainTextContentControl1_StoreUpdating(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContentControlStoreUpdatingEventArgs) _
    Handles PlainTextContentControl1.StoreUpdating

    MessageBox.Show("The control was changed to the following value: " & vbCrLf & _
        e.Content & vbCrLf & "This value is about to be written to the node that is bound to this control.")
End Sub

Private Sub plainTextContentControl1_ContentUpdating(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContentControlContentUpdatingEventArgs) _
    Handles PlainTextContentControl1.ContentUpdating

    MessageBox.Show("The node that is bound to this control was changed to the following value: " & vbCrLf & _
        e.Content & vbCrLf & "This value is about to be written to this control.")
End Sub

void plainTextContentControl1_StoreUpdating(object sender, 
    Microsoft.Office.Tools.Word.ContentControlStoreUpdatingEventArgs e)
{
    MessageBox.Show("The control was changed to the following value: \n\n" +
        e.Content + "\n\nThis value is about to be written to the node that is bound to this control.");
}

void plainTextContentControl1_ContentUpdating(object sender, 
    Microsoft.Office.Tools.Word.ContentControlContentUpdatingEventArgs e)
{
    MessageBox.Show("The node that is bound to this control was changed to the following value: \n\n" +
        e.Content + "\n\nThis value is about to be written to this control.");
}

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