XMLNodes.Add (Método)

Obtiene un objeto Microsoft.Office.Interop.Word.XMLNode que representa un elemento recién agregado.

Espacio de nombres:  Microsoft.Office.Tools.Word
Ensamblado:  Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)

Sintaxis

'Declaración
Function Add ( _
    Name As String, _
    Namespace As String, _
    ByRef Range As Object _
) As XMLNode

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

Parámetros

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

• Namespace
  Tipo: System.String
  Nombre del esquema tal y como está definido en el esquema.El parámetro Namespace distingue entre mayúsculas y 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
  Tipo: System.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.

Valor devuelto

Tipo: Microsoft.Office.Interop.Word.XMLNode
Un objeto Microsoft.Office.Interop.Word.XMLNode que representa un elemento recién agregado.

Comentarios

Parámetros opcionales

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

Ejemplos

En el siguiente ejemplo de código se muestran los controladores de eventos para los eventos AfterInsert y BeforeDelete. El código muestra un cuadro de mensaje antes de que se elimine un objeto Microsoft.Office.Interop.Word.XMLNode del documento y después de que se agregue un objeto Microsoft.Office.Interop.Word.XMLNode al documento. En el ejemplo también se utiliza el método Add para agregar un nuevo elemento a una colección XMLNodes en un intervalo especificado y provocar mediante programación el evento AfterInsert. En este ejemplo, se supone que el documento actual contiene una colección XMLNodes denominada SampleInsertNodes, que tiene un XMLNode primario llamado 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.");
    }
}

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

XMLNodes Interfaz

Microsoft.Office.Tools.Word (Espacio de nombres)