Evento ContentControlBase.ContentUpdating

Artigo
05/21/2013

Ocorre antes que o Microsoft Office Word atualiza o texto no controle de conteúdo, se o controle de conteúdo está associado a uma parte personalizado XML.

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

Sintaxe

'Declaração
Event ContentUpdating As ContentControlContentUpdatingEventHandler

event ContentControlContentUpdatingEventHandler ContentUpdating

Comentários

Você pode associar controles de conteúdo a um elemento em uma parte XML (também chamado parte de costume XML) que é inserida no documento.Para obter mais informações, consulte Controles de conteúdo e Visão geral de partes XML personalizada.

O evento de ContentUpdating é gerado apenas se os dados em uma parte XML personalizado são alterados quando o documento está aberto.Esse evento não é gerado quando o documento está aberto e os dados em uma parte XML personalizado foi modificado quando o documento foi fechada.

Para obter mais informações sobre manipulação de eventos, consulte Consumindo eventos.

Exemplos

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

Para usar este código, cole na classe de ThisDocument em seu projeto.Para C#, você também deve anexar manipuladores de eventos a eventos de ContentUpdating e de StoreUpdating de plainTextContentControl1.

Este exemplo é para uma personalização da nível.

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.