Propriedade ContentControlContentUpdatingEventArgs.Content

Artigo
05/21/2013

Obtém ou define o texto que está sendo gravado para o controle de conteúdo da parte XML personalizada que é vinculado ao controle.

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

Sintaxe

'Declaração
Property Content As String

string Content { get; set; }

Valor de propriedade

Tipo: System.String
O texto que está sendo gravado para o controle de conteúdo da parte XML personalizada que é vinculado ao controle.

Comentários

Você pode vincular controles de conteúdo a um elemento em um trecho de XML (também denominada parte XML personalizada) que está incorporada no documento.Use o Content propriedade para alterar o texto antes de Microsoft Office o Word atualiza o controle.

Para obter mais informações, consulte Controles de conteúdo e Visão geral de partes XML personalizada.

Exemplos

O exemplo de código a seguir demonstra os manipuladores de eventos para o ContentUpdating e StoreUpdating eventos.Este exemplo assume que o documento contém um PlainTextContentControl chamado plainTextContentControl1 que está vinculado a um elemento em um componente XML personalizado.Para obter um exemplo de código que demonstra como vincular um controle de conteúdo a um elemento em uma parte XML personalizada, consulte Passo a passo: Controles de conteúdo ligação às partes do XML personalizado.

Para usar esse código, colá-lo para o ThisDocument classe em seu projeto.Para C#, você também deve anexar os manipuladores de eventos para o ContentUpdating e StoreUpdating eventos de plainTextContentControl1.

Este exemplo é para uma personalização em nível de documento.Você pode modificá-lo para ser executado em um suplemento em nível de aplicativo.Para obter mais informações, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

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.");
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.