Insert

NodeCollection.Insert method

Inserta un nodo en la colección en el índice especificado.

public void Insert(int index, Node node)
ParámetroEscribeDescripción
indexInt32El índice de base cero del nodo. Se permiten índices negativos e indican el acceso desde el final de la lista. Por ejemplo, -1 significa el último nodo, -2 significa el penúltimo y así sucesivamente.
nodeNodeEl nodo a insertar.

Excepciones

excepcióncondición
NotSupportedExceptionElNodeCollection Es una colección “profunda”.

Observaciones

El nodo se inserta como hijo en el objeto de nodo a partir del cual se creó la colección.

Si el índice es igual o mayor queCount, el nodo se agrega al final de la colección.

Si el índice es negativo y su valor absoluto es mayor queCount, el nodo se agrega al final de la colección.

Si el nodo que se está insertando se creó a partir de otro documento, debe usar ImportNode para importar el nodo al documento actual. El nodo importado luego se puede insertar en el documento actual.

Ejemplos

Muestra cómo trabajar con NodeCollection.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Agrega texto al documento insertando Ejecuciones usando un DocumentBuilder.
builder.Write("Run 1. ");
builder.Write("Run 2. ");

// Cada invocación del método "Write" crea una nueva Ejecución,
// que luego aparece en RunCollection del párrafo principal.
RunCollection runs = doc.FirstSection.Body.FirstParagraph.Runs;

Assert.AreEqual(2, runs.Count);

// También podemos insertar un nodo en RunCollection manualmente.
Run newRun = new Run(doc, "Run 3. ");
runs.Insert(3, newRun);

Assert.True(runs.Contains(newRun));
Assert.AreEqual("Run 1. Run 2. Run 3.", doc.GetText().Trim());

// Acceda a ejecuciones individuales y elimínelas para eliminar su texto del documento.
Run run = runs[1];
runs.Remove(run);

Assert.AreEqual("Run 1. Run 3.", doc.GetText().Trim());
Assert.NotNull(run);
Assert.False(runs.Contains(run));

Ver también

NodeCollection.IndexOf NodeCollection.Remove