Insert

NodeCollection.Insert method

Insère un nœud dans la collection à l’index spécifié.

public void Insert(int index, Node node)
ParamètreTaperLa description
indexInt32L’index de base zéro du nœud. Les index négatifs sont autorisés et indiquent l’accès depuis l’arrière de la liste. Par exemple -1 signifie le dernier nœud, -2 signifie l’avant-dernier et ainsi de suite.
nodeNodeLe nœud à insérer.

Exceptions

exceptioncondition
NotSupportedExceptionLeNodeCollection est une collection “profonde”.

Remarques

Le nœud est inséré en tant qu’enfant dans l’objet nœud à partir duquel la collection a été créée.

Si l’indice est égal ou supérieur àCount, le nœud est ajouté à la fin de la collection.

Si l’indice est négatif et que sa valeur absolue est supérieure àCount, le nœud est ajouté à la fin de la collection.

Si le nœud en cours d’insertion a été créé à partir d’un autre document, vous devez utiliser ImportNode pour importer le nœud dans le document actuel. Le nœud importé peut ensuite être inséré dans le document actuel.

Exemples

Montre comment travailler avec un NodeCollection.

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

// Ajoutez du texte au document en insérant des Runs à l'aide d'un DocumentBuilder.
builder.Write("Run 1. ");
builder.Write("Run 2. ");

// Chaque invocation de la méthode "Write" crée un nouveau Run,
// qui apparaît ensuite dans la RunCollection du paragraphe parent.
RunCollection runs = doc.FirstSection.Body.FirstParagraph.Runs;

Assert.AreEqual(2, runs.Count);

// Nous pouvons également insérer manuellement un nœud dans RunCollection.
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());

// Accédez aux exécutions individuelles et supprimez-les pour supprimer leur texte du document.
Run run = runs[1];
runs.Remove(run);

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

Voir également

NodeCollection.IndexOf NodeCollection.Remove