Bookmark.InsertXML 方法
將指定的 XML 文字插入 Bookmark 控制項中。
命名空間: Microsoft.Office.Tools.Word
組件: Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)
語法
'宣告
Sub InsertXML ( _
XML As String, _
ByRef Transform As Object _
)
void InsertXML(
string XML,
ref Object Transform
)
參數
- XML
型別:System.String
要插入的 XML 文字。
- Transform
型別:System.Object%
要套用至插入的 XML 文字轉換。
備註
如果 Bookmark 控制項包含文字,則 InsertXML 方法會取代現有的文字。
呼叫這個方法可能會刪除 Bookmark 控制項。
使用 InsertXML 方法插入使用任意 XML 或 Word XML 所標記的文字。 XML 必須是語法正確的。 如果使用 Word XML,則根據 Word XML 結構描述也必須是有效的。
如果指定的 XML 文字無法插入 Bookmark 控制項,便會顯示錯誤訊息。
選擇性參數
如需選擇性參數的詳細資訊,請參閱Office 方案中的選擇性參數。
範例
下列程式碼範例將 Bookmark 控制項加入至文件,然後將 XML 文字插入到書籤中。 之後會顯示訊息方塊,顯示 XMLNodes 的總數目以及書籤的 XML 內容。
這是示範文件層級自訂的範例。
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]);
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。