ContentControlBase.StoreUpdating (Evento)

Artículo
08/10/2011

Se produce inmediatamente antes de que Microsoft Office Word actualice los datos de un elemento XML personalizado que está enlazado al control de contenido (es decir, una vez que se ha modificado el texto del control de contenido).

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

Sintaxis

'Declaración
Event StoreUpdating As ContentControlStoreUpdatingEventHandler

event ContentControlStoreUpdatingEventHandler StoreUpdating

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 StoreUpdating se produce cuando el texto de un control de contenido cambia y el control de contenido está enlazado a un elemento XML personalizado.

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 StoreUpdating y ContentUpdating. 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 StoreUpdating y ContentUpdating de plainTextContentControl1.

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.