Metodo Bookmark.InsertXML

Articolo
01/06/2014

Inserisce il testo XML specificato nel controllo Bookmark.

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

Sintassi

'Dichiarazione
Sub InsertXML ( _
    XML As String, _
    ByRef Transform As Object _
)

void InsertXML(
    string XML,
    ref Object Transform
)

Parametri

XML
Tipo: System.String
Testo XML da inserire.

Transform
Tipo: System.Object%
Trasformazione da applicare al testo XML inserito.

Note

Se il controllo Bookmark contiene testo, il metodo InsertXML sostituirà il testo esistente.

La chiamata a questo metodo potrebbe causare l'eliminazione del controllo Bookmark.

Utilizzare il metodo InsertXML per inserire il testo contrassegnato con XML arbitrario o XML di Word. È necessario che il codice XML presenti un formato corretto. Se viene utilizzato XML di Word, dovrà essere valido in base allo schema XML di Word.

Se non è possibile inserire il testo XML specificato nel controllo Bookmark, verrà visualizzato un messaggio di errore.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente viene aggiunto un controllo Bookmark al documento e viene inserito testo XML nel segnalibro. Viene quindi visualizzata una finestra di messaggio per mostrare il numero totale di XMLNodes e il contenuto XML del segnalibro.

Questo esempio è valido per una personalizzazione a livello di documento.

Private Sub BookmarkInsertXML()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "Sample of bookmark text."
    Bookmark1.Words(1).InsertXML( _
        "<example>This is an example.</example>")
    MessageBox.Show("Total XMLNodes in Bookmark1: " & _
        Bookmark1.XMLNodes.Count.ToString & vbLf & vbLf & _
        "XML contents: " & Bookmark1.XML(True))

End Sub

private void BookmarkInsertXML()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "Sample of bookmark text.";

    bookmark1.Words[1].InsertXML("<example>This is an example.</example>",
        ref missing);

    MessageBox.Show("Total XMLNodes in bookmark1: " + bookmark1.XMLNodes.Count +
        "\n" + "XML contents: " + bookmark1.XML[true]);
}

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.

Vedere anche

Riferimenti

Bookmark Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite