XMLNodes.Add メソッド
新しく追加された要素を表す Microsoft.Office.Interop.Word.XMLNode オブジェクトを取得します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)
構文
'宣言
Function Add ( _
Name As String, _
Namespace As String, _
ByRef Range As Object _
) As XMLNode
XMLNode Add(
string Name,
string Namespace,
ref Object Range
)
パラメーター
- Name
型: System.String
Namespace パラメーターで指定された XML スキーマ内の要素の名前。XML では大文字と小文字が区別されるため、Name パラメーターに指定される要素のスペルは、スキーマに指定されたスペルとまったく同じであることが必要です。Namespace パラメーターに指定されたスキーマ内の要素名に 1 つでも一致しないものがあると、エラーが表示されます。
- 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 イベントをプログラムから発生させます。 この例では、現在の文書に、SampleNode という名前の XMLNode が親である、SampleInsertNodes という名前の XMLNodes コレクションが含まれていることが前提となっています。
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)
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)
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.");
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。