XMLNodes.Add 方法 (2007 系統)
更新：2007 年 11 月
取得 Microsoft.Office.Interop.Word.XMLNode 物件，表示新加入的項目。
命名空間： Microsoft.Office.Tools.Word
組件： Microsoft.Office.Tools.Word.v9.0 (在 Microsoft.Office.Tools.Word.v9.0.dll 中)
語法
Public Function Add ( _
Name As String, _
Namespace As String, _
ByRef Range As Object _
) As XMLNode
Dim instance As XMLNodes
Dim Name As String
Dim Namespace As String
Dim Range As Object
Dim returnValue As XMLNode
returnValue = instance.Add(Name, Namespace, _
Range)
public XMLNode Add(
string Name,
string Namespace,
ref Object Range
)
參數
Name
型別：System.String在 Namespace 參數中所指定之 XML 結構描述內的物件名稱。因為 XML 會區分大小寫，所以在 Name 參數中指定的項目拼字必須和該項目在結構描述中所顯示的完全一致。如果不符合任何一個由 Namespace 參數所指定在結構描述中的物件名稱，就會顯示錯誤。
Namespace
型別：System.String在結構描述中所定義的結構描述名稱。Namespace 參數會區分大小寫，因此拼字必須和在結構描述中所顯示的完全一致。如果在附加到文件的結構描述中都找不到指定的命名空間，就會顯示錯誤。
Range
型別：System.Object%您要套用項目的範圍。預設值是將項目標記放在插入點上，或者如果有選取文字，就把項目標記放在選取範圍的周圍。
傳回值
型別：Microsoft.Office.Interop.Word.XMLNode
Microsoft.Office.Interop.Word.XMLNode 物件，表示新加入的項目。
備註
選擇性參數
如需選擇性參數的詳細資訊，請參閱了解 Office 方案中的選擇性參數。
範例
下列程式碼範例會示範 AfterInsert 和 BeforeDelete 事件的事件處理常式。在從文件中刪除 Microsoft.Office.Interop.Word.XMLNode 之前，以及將 Microsoft.Office.Interop.Word.XMLNode 加入至文件之後，程式碼會顯示訊息方塊。範例也使用 Add 方法，在指定的範圍上將新項目加入 XMLNodes 集合，並且用程式設計的方式引發 AfterInsert 事件。這個範例假設目前文件包含名為 SampleInsertNodes 的 XMLNodes 集合，這個集合有名為 SampleNode 的父 XMLNode。
Private Sub XMLNodeAddAndDelete()
Dim range1 As Object = Me.SampleInsertNodes(1).Range
' This will raise the AfterInsert event.
Dim node1 As Word.XMLNode = _
Me.SampleInsertNodes.Add("MemoFrom", _
Me.SampleNode.NamespaceURI, range1)
End Sub
Private Sub SampleInsertNodes_AfterInsert(ByVal sender As Object, _
ByVal e As Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs) _
Handles SampleInsertNodes.AfterInsert
If e.InUndoRedo Then
MessageBox.Show("A child element of SampleInsertNodes was " & _
"inserted as a result of an undo or redo operation.")
Else
MessageBox.Show("A child element of SampleInsertNodes " & _
"was inserted.")
End If
End Sub
Private Sub SampleInsertNodes_BeforeDelete(ByVal sender As Object, _
ByVal e As Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs) _
Handles SampleInsertNodes.BeforeDelete
If e.InUndoRedo Then
MessageBox.Show("A child element of SampleInsertNodes " & _
"is about to be deleted as a result of an undo or " & _
"redo operation.")
Else
MessageBox.Show("A child element of SampleInsertNodes " & _
"is about to be deleted.")
End If
End Sub
private void XMLNodeAddAndDelete()
{
object range1 = this.SampleInsertNodes[1].Range;
this.SampleInsertNodes.AfterInsert +=
new Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventHandler(
SampleInsertNodes_AfterInsert);
this.SampleInsertNodes.BeforeDelete +=
new Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventHandler(
SampleInsertNodes_BeforeDelete);
// This will raise the AfterInsert event.
Word.XMLNode node1 = this.SampleInsertNodes.Add("MemoFrom",
this.SampleNode.NamespaceURI, ref range1);
}
void SampleInsertNodes_AfterInsert(object sender,
Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs e)
{
if (e.InUndoRedo)
{
MessageBox.Show("A child element of SampleInsertNodes was " +
"inserted as a result of an undo or redo operation.");
}
else
{
MessageBox.Show("A child element of SampleInsertNodes " +
"was inserted.");
}
}
void SampleInsertNodes_BeforeDelete(object sender,
Microsoft.Office.Tools.Word.NodeInsertAndDeleteEventArgs e)
{
if (e.InUndoRedo)
{
MessageBox.Show("A child element of SampleInsertNodes " +
"is about to be deleted as a result of an undo or " +
"redo operation.");
}
else
{
MessageBox.Show("A child element of SampleInsertNodes " +
"is about to be deleted.");
}
}
使用權限
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。