Proprietà ContentControlContentUpdatingEventArgs.Content

Ottiene o imposta il testo scritto nel controllo contenuto dalla web part XML personalizzata associata al controllo.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Property Content As String
    Get
    Set

string Content { get; set; }

Valore proprietà

Tipo: System.String
Testo scritto nel controllo contenuto dalla web part XML personalizzata associata al controllo.

Note

È possibile associare i controlli contenuto a un elemento in una porzione di codice XML, anche detta web part XML personalizzata, incorporata nel documento. Utilizzare la proprietà Content per modificare il testo prima che il controllo venga aggiornato in Microsoft Office Word.

Per ulteriori informazioni, vedere Controlli del contenuto e Cenni preliminari sulle web part XML personalizzate.

Esempi

Nell'esempio di codice riportato di seguito vengono illustrati i gestori eventi per gli eventi ContentUpdating e StoreUpdating. In questo esempio si presuppone che nel documento sia contenuto un oggetto PlainTextContentControl denominato plainTextContentControl1 associato a un elemento di una Web part XML personalizzata. Per un esempio di codice in cui viene illustrato come associare un controllo del contenuto a un elemento di una Web part XML personalizzata, vedere Procedura dettagliata: associazione dei controlli del contenuto a parti XML personalizzate.

Per utilizzare il codice, incollarlo nella classe ThisDocument del progetto. In C# è inoltre necessario collegare i gestori eventi agli eventi ContentUpdating e StoreUpdating di plainTextContentControl1.

Questo esempio è valido per una personalizzazione a livello di documento. È possibile modificarlo per eseguirlo in un componente aggiuntivo a livello di applicazione. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.