Insert

NodeCollection.Insert method

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

public void Insert(int index, Node node)
Parámetro Escribe Descripción
index Int32 El índice de base cero del nodo. Los índices negativos están permitidos 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.
node Node El nodo a insertar.

Excepciones

excepción condición
NotSupportedException los Colección de nodos es una colección “profunda”.

Observaciones

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

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

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

Si newChild ya está en el árbol, primero se elimina.

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 se puede insertar en el documento actual.

Ejemplos

Muestra cómo trabajar con NodeCollection.

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

// Agregue texto al documento insertando Se ejecuta 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