XMLNodes.Add – metoda

Článek
05/14/2013

Získá Microsoft.Office.Interop.Word.XMLNode objekt, který představuje nově přidaný prvek.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

XMLNode Add(
    string Name,
    string Namespace,
    ref Object Range
)

Parametry

Name
Typ: System.String
Název elementu ve schématu XML, který je určen v Namespace parametr.Protože XML rozlišuje velká a malá písmena, podle pravopisu prvek Name parametr musí být úplně stejně jako ve schématu.Pokud neodpovídá žádné názvy prvků ve schématu v Namespace zobrazí parametr chybu.

Namespace
Typ: System.String
Název schématu, jak jsou definovány ve schématu. Namespace Parametr je malá a velká písmena a musí být zadán přesně tak, jak je ve schématu.Je-li zadaný obor názvů nelze najít v žádném schémat, připojené k dokumentu, zobrazí se chyba.

Range
Typ: System.Object%
Oblast, do které chcete použít prvek.Ve výchozím nastavení je umístit značek prvků na pozici kurzoru nebo ve výběru, je-li vybrán text.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode objekt, který představuje nově přidaný prvek.

Poznámky

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu ukazuje obslužných rutin událostí AfterInsert a BeforeDelete události.Kód zobrazí okno se zprávou před Microsoft.Office.Interop.Word.XMLNode je odstraněn z dokumentu a po Microsoft.Office.Interop.Word.XMLNode je přidán do dokumentu.V příkladu se používá také Add metodu k přidání nového prvku do XMLNodes kolekce v určeném rozsahu a programově zvýšit AfterInsert události.Tento příklad předpokládá, že obsahuje aktuální dokument XMLNodes kolekci s názvem SampleInsertNodes, který má nadřazenou XMLNode s názvem SampleNode.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

XMLNodes Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím