Insert

NodeCollection.Insert method

Infogar en nod i samlingen vid det angivna indexet.

public void Insert(int index, Node node)
ParameterTypBeskrivning
indexInt32Nodens nollbaserade index. Negativa index är tillåtna och indikerar åtkomst från listans bakre del. Till exempel betyder -1 den sista noden, -2 betyder den näst före sista och så vidare.
nodeNodeNoden som ska infogas.

Undantag

undantagskick
NotSupportedExceptionDeNodeCollection är en “djup” samling.

Anmärkningar

Noden infogas som ett underordnat objekt i nodobjektet från vilket samlingen skapades.

Om indexet är lika med eller större änCount, noden läggs till i slutet av samlingen.

Om indexet är negativt och dess absoluta värde är större änCount, noden läggs till i slutet av samlingen.

Om noden som infogas skapades från ett annat dokument bör du använda ImportNode för att importera noden till det aktuella dokumentet. Den importerade noden kan sedan infogas i det aktuella dokumentet.

Exempel

Visar hur man arbetar med en NodeCollection.

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

// Lägg till text i dokumentet genom att infoga Runs med hjälp av en DocumentBuilder.
builder.Write("Run 1. ");
builder.Write("Run 2. ");

// Varje anrop av metoden "Write" skapar en ny Run,
// som sedan visas i det överordnade styckets RunCollection.
RunCollection runs = doc.FirstSection.Body.FirstParagraph.Runs;

Assert.AreEqual(2, runs.Count);

// Vi kan också infoga en nod i RunCollection manuellt.
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());

// Få åtkomst till enskilda körningar och ta bort dem för att ta bort deras text från dokumentet.
Run run = runs[1];
runs.Remove(run);

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

Se även

NodeCollection.IndexOf NodeCollection.Remove