Udostępnij za pośrednictwem

Metoda XMLNodes.Add —

  • Artykuł

Pobiera Microsoft.Office.Interop.Word.XMLNode obiekt, który reprezentuje element nowo dodane.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
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
    Nazwa elementu w schemacie XML, wyznaczone w Namespace parametru.Ponieważ kod XML jest uwzględniana wielkość liter, pisownię elementu określona w Name parametr musi być dokładnie taką jaka widnieje w schemacie.Jeśli to nie pasuje do żadnego z nazwy elementu w schemacie, określonych w Namespace parametr, błąd jest wyświetlany.
  • Namespace
    Typ: System.String
    Nazwa schematu, zgodnie z definicją w schemacie. Namespace Parametr jest uwzględniana wielkość liter i musi być pisana dokładnie taką jaka widnieje w schemacie.Jeśli nie można odnaleźć określonej przestrzeni nazw w dowolnym schematów dołączonym do dokumentu, wyświetlany jest błąd.
  • Range
    Typ: System.Object%
    Zakres, do którego chcesz zastosować element.Wartość domyślna to umieścić znaczniki elementów w punkcie wstawiania lub wokół zaznaczenia, jeśli jest zaznaczony tekst.

Wartość zwracana

Typ: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode obiekt, który reprezentuje element nowo dodane.

Uwagi

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

Poniższy przykład kodu pokazuje obsługę zdarzeń dla AfterInsert i BeforeDelete zdarzenia.Kod wyświetla okno komunikatu przed Microsoft.Office.Interop.Word.XMLNode jest usuwany z dokumentu i po Microsoft.Office.Interop.Word.XMLNode jest dodawane do dokumentu.W przykładzie użyto również Add metoda, aby dodać nowy element do XMLNodes kolekcji w określonym zakresie programowe i podnieść AfterInsert zdarzenia.W tym przykładzie założono, że bieżący dokument zawiera XMLNodes kolekcji o nazwie SampleInsertNodes, który ma element nadrzędny XMLNode o nazwie 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.");
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

XMLNodes Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Word