XMLNodes.Add(String, String, Object) メソッド

定義

名前空間:

Microsoft.Office.Tools.Word

アセンブリ:

Microsoft.Office.Tools.Word.dll

新しく追加された要素を表す XMLNode オブジェクトを取得します。

public Microsoft.Office.Interop.Word.XMLNode Add (string Name, string Namespace, ref object Range);

abstract member Add : string * string * obj -> Microsoft.Office.Interop.Word.XMLNode

Public Function Add (Name As String, Namespace As String, Optional ByRef Range As Object) As XMLNode

パラメーター

Name

String

パラメーターで指定された XML スキーマ内の要素の Namespace 名前。 XML では大文字と小文字が区別されるため、 パラメーターで Name 指定された要素のスペルは、スキーマに表示されるとおりである必要があります。 パラメーターで指定された Namespace スキーマ内の要素名と一致しない場合は、エラーが表示されます。

Namespace

String

スキーマ内に定義されたスキーマの名前。 パラメーターでは Namespace 大文字と小文字が区別され、スキーマに表示されるとおりにスペルを指定する必要があります。 指定された名前空間が、文書に追加されたどのスキーマにも見つからない場合は、エラーが表示されます。

Range

Object

要素を適用する範囲。 既定では、要素タグが挿入位置に置かれます。または、テキストが選択されている場合は選択の前後に置かれます。

戻り値

XMLNode

新しく追加された要素を表す XMLNode オブジェクト。

例

次のコード例では、 イベントと BeforeDelete イベントのイベント ハンドラーをAfterInsert示します。 コードは、 がドキュメントから削除される前 Microsoft.Office.Interop.Word.XMLNode と、 がドキュメントに追加された後 Microsoft.Office.Interop.Word.XMLNode にメッセージ ボックスを表示します。 この例では、 メソッドを Add 使用して、指定した範囲のコレクションに新しい要素を XMLNodes 追加し、プログラムによって イベントを AfterInsert 発生させます。 この例では、現在のドキュメントに という名前SampleInsertNodesのコレクションが含まれていることをXMLNodes前提としています。このコレクションには、 という名前SampleNodeの親XMLNodeが含まれています。

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.");
    }
}

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

注釈

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。