XMLNodes.Add – metoda

Článek
08/11/2011

Získává Microsoft.Office.Interop.Word.XMLNode objekt představující 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 prvku jazyk XML schéma v Namespace parametr.Protože rozlišuje jazyk XML podle pravopisu prvek Name parametr musí být úplně stejně jako ve schéma.Pokud neodpovídá žádné názvy prvků ve schéma v Namespacezobrazíparametr chyba .

Namespace
Typ: System.String
Název schéma definovaných ve schéma.Namespaceparametr rozlišuje a musí být napsána úplně stejně jako ve schéma. Zadaný obor názvů nebyl nalezen v žádném schémata připojené k dokumentu, zobrazí se chyba .

Range
Typ: System.Object%
Oblast, do které chcete párovat prvek.Ve výchozím nastavení je toto tagů elementů v místě kurzoru nebo ve výběr , pokud vybraný text.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode objekt představující nově přidaný prvek.

Poznámky

Volitelné parametry

Informace o volitelných parametrů, viz The Variable missing and Optional Parameters in Office Solutions.

Příklady

Následující příklad kódu ukazuje obslužné rutiny pro AfterInsert a BeforeDelete události. Kód se zobrazí okno zprávy před Microsoft.Office.Interop.Word.XMLNode odstraněn z dokumentu a po Microsoft.Office.Interop.Word.XMLNode se přidá do dokumentu. Příklad používá také Add metoda přidat nový prvek XMLNodes kolekce na zadaný rozsah a programově zvýšit AfterInsert událost. Tento příklad předpokládá, že obsahuje aktuální dokument XMLNodes kolekce s názvem SampleInsertNodes, který má nadřazený 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é

Odkaz

XMLNodes Rozhraní

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

Sdílet prostřednictvím