XMLNodes.Add メソッド (2007 System)
更新 : 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.StringNamespace パラメータで指定された 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) _
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.");
}
}
アクセス許可
- 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。