ContentControlBase.ContentUpdating (Evento)

Artículo
08/10/2011

Se produce inmediatamente antes de que Microsoft Office Word actualice el texto del control de contenido, si el control de contenido está enlazado a un elemento XML personalizado.

Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)

Sintaxis

'Declaración
Event ContentUpdating As ContentControlContentUpdatingEventHandler

event ContentControlContentUpdatingEventHandler ContentUpdating

Comentarios

Puede enlazar los controles de contenido a un elemento de un fragmento XML (también denominado elemento XML personalizado) que esté incrustado en el documento. Para obtener más información, vea Controles de contenido y Información general sobre los elementos XML personalizados.

El evento ContentUpdating se produce únicamente si los datos de un elemento XML personalizado se modifican cuando el documento está abierto. Este evento no se provoca cuando el documento está abierto, pero los datos de un elemento XML personalizado se modificaron mientras estaba cerrado.

Para obtener más información sobre cómo controlar eventos, vea Utilizar eventos.

Ejemplos

En el siguiente ejemplo de código se muestran los controladores de eventos para los eventos ContentUpdating y StoreUpdating. En este ejemplo se supone que el documento contiene un PlainTextContentControl denominado plainTextContentControl1 que está enlazado a un elemento en un elemento XML personalizado. Para obtener un ejemplo de código donde se muestra cómo enlazar un control de contenido a un elemento en un elemento XML personalizado, vea Tutorial: Enlazar controles de contenido a elementos XML personalizados.

Para usar este código, péguelo en la clase ThisDocument del proyecto. En C#, además debe asociar los controladores de eventos a los eventos ContentUpdating y StoreUpdating de plainTextContentControl1.

Se trata de un ejemplo para una personalización en el nivel del documento.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.