ContentControlStoreUpdatingEventArgs.Content-Eigenschaft

Artikel
01/03/2014

Ruft den Text ab, der im benutzerdefinierten XML-Abschnitt gespeichert 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 im benutzerdefinierten XML-Abschnitt gespeichert 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 den benutzerdefinierten XML-Abschnitt aktualisiert, der an das Steuerelement gebunden ist.

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

Beispiele

Im folgenden Codebeispiel werden Ereignishandler für das StoreUpdating-Ereignis und das ContentUpdating-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 StoreUpdating-Ereignis und das ContentUpdating-Ereignis von plainTextContentControl1 anfügen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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.