XMLNodes.Add(String, String, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Obtiene un objeto XMLNode que representa un elemento recién agregado.

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

Parámetros

Name

String

Nombre del elemento en el esquema XML designado en el Namespace parámetro . Dado que XML distingue mayúsculas de minúsculas, la ortografía del elemento especificado en el Name parámetro debe ser exactamente como aparece en el esquema. Si no coincide con ninguno de los nombres de elemento del esquema especificado en el Namespace parámetro , se muestra un error.

Namespace

String

Nombre del esquema tal y como está definido en el esquema. El Namespace parámetro distingue mayúsculas de minúsculas y debe escribirse exactamente como aparece en el esquema. Si el espacio de nombres especificado no se encuentra en ninguno de los esquemas asociados al documento, se mostrará un error.

Range

Object

Intervalo al que se desea aplicar el elemento. De manera predeterminada, las etiquetas de elemento se colocan en el punto de inserción o delante y detrás de la selección si hay un texto seleccionado.

Devoluciones

XMLNode

Un objeto XMLNode que representa un elemento recién agregado.

Ejemplos

En el ejemplo de código siguiente se muestran los controladores de eventos para los AfterInsert eventos y BeforeDelete . El código muestra un cuadro de mensaje antes de eliminar un Microsoft.Office.Interop.Word.XMLNode elemento del documento y después de agregar un Microsoft.Office.Interop.Word.XMLNode elemento al documento. En el ejemplo también se usa el Add método para agregar un nuevo elemento a una XMLNodes colección en un intervalo especificado y generar el AfterInsert evento mediante programación. En este ejemplo se supone que el documento actual contiene una XMLNodes colección denominada SampleInsertNodes, que tiene un elemento primario XMLNode denominado SampleNode.

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

Comentarios

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.