Een tabel aanmaken

Aspose.Words stelt gebruikers in staat om tabellen te maken in een document vanaf nul en biedt verschillende methoden om dit te doen. Dit artikel geeft details over hoe u geformatteerde tabellen toe te voegen aan uw document met behulp van elke methode, evenals een vergelijking van elke methode aan het einde van het artikel.

Standaard tabelstijlen

De nieuw aangemaakte tabel krijgt standaardwaarden die vergelijkbaar zijn met die in Microsoft Word:

Tabeleigenschappen Standaard in Aspose.Words
Border Style Single
Border Width 1/2 pt
Randkleur Black
Left and Right Padding 5.4 pts
AutoFit Mode AutoFit to Window
Allow AutoFit True

Een tabel aanmaken met DocumentBuilder

In Aspose.Words, gebruikers kunnen een tabel maken in een document met behulp van de DocumentBuilder. Het basisalgoritme voor het maken van een tabel is als volgt:

  1. Start de tabel met StartTable
  2. Voeg een cel toe aan de tabel met InsertCell Dit start automatisch een nieuwe rij
  3. Optioneel, gebruik de CellFormat eigenschap om celopmaak op te geven
  4. De celinhoud invoegen met behulp van de juiste DocumentBuilder methoden zoals Writeln, InsertImage, en andere
  5. Herhaal stap 2-4 totdat de rij voltooid is
  6. Oproep EndRow om de huidige rij te beëindigen
  7. Optioneel, gebruik de RowFormat eigenschap om rijopmaak op te geven
  8. Herhaal stap 2-7 totdat de tabel volledig is
  9. Oproep EndTable om de tafel te bouwen

Het proces van het maken van een tabel is duidelijk te zien in de volgende afbeelding:

creating-table-process

Het volgende voorbeeld van code laat zien hoe u een eenvoudige tabel maakt met behulp van DocumentBuilder met standaardopmaak:

Het volgende voorbeeld van code laat zien hoe u een geformatteerde tabel maakt met behulp van DocumentBuilder:

Het volgende voorbeeld van code laat zien hoe je een geneste tabel invoegt met behulp van DocumentBuilder:

Een tabel aanmaken via DOM (Document Object Model)

U kunt tabellen direct invoegen in de DOM door een nieuwe Table knooppunt op een specifieke positie.

Houd er rekening mee dat direct na het aanmaken van de tabel node, de tabel zelf volledig leeg zal zijn, dat wil zeggen dat het nog geen rijen en cellen bevat. Om rijen en cellen in een tabel in te voegen, voeg de juiste Row en Cell kindknooppunten naar de DOM.

Het volgende voorbeeld van code laat zien hoe je een nieuwe tabel vanaf nul kunt bouwen door de juiste kindknooppunten toe te voegen aan de documentboom:

Een tabel aanmaken van HTML

Aspose.Words ondersteunt het invoegen van inhoud in een document van een HTML bron met behulp van de InsertHtml methode. De invoer kan een volledige HTML-pagina of slechts een gedeeltelijke knipsel zijn.

Dit gebruiken InsertHtml methode, kunnen gebruikers tabellen in het document via tabel tags zoals <table>, <tr>, <td>.

Het volgende voorbeeld van code laat zien hoe u een tabel in een document van een string met HTML-tags invoegt:

Een kopie van een bestaande tabel invoegen

Er zijn vaak momenten dat je een tabel moet maken op basis van een reeds bestaande tabel in een document. De eenvoudigste manier om een tabel te dupliceren met behoud van alle opmaak is om de tabel knooppunt te klonen met behulp van de deepClone methode.

Dezelfde techniek kan worden gebruikt om kopieën van een bestaande rij of cel aan een tabel toe te voegen.

Het volgende voorbeeld van code laat zien hoe een tabel te dupliceren met behulp van node constructors:

Het volgende voorbeeld van code laat zien hoe je de laatste rij van een tabel kloont en toevoegt aan de tabel:

Als u kijkt naar het maken van tabellen in een document dat dynamisch groeit met elke record van uw gegevensbron, dan wordt de bovenstaande methode niet geadviseerd. In plaats daarvan wordt de gewenste output gemakkelijker bereikt door het gebruik van Mail merge Met betrekking tot de gebieden. U kunt meer over deze techniek leren in de Mail Merge met regio’s Section.

Manieren vergelijken om een tabel aan te maken

Aspose.Words biedt verschillende methoden om nieuwe tabellen aan te maken in een document. Elke methode heeft zijn eigen voor- en nadelen, dus de keuze van welke methode vaak afhankelijk is van de specifieke situatie.

Laten we eens kijken naar deze manieren om tabellen te maken en hun voor- en nadelen te vergelijken:

Methode Voordelen Nadelen
Via DocumentBuilder De standaardmethode voor het invoegen van tabellen en andere documentinhoud Soms moeilijk om vele soorten tabellen tegelijk met dezelfde bouwer instantie te creëren
Via DOM Past beter met de omringende code die knooppunten direct in de DOM zonder gebruik van een DocumentBuilder De tabel is aangemaakt “leeg”: voordat u de meeste operaties uitvoert, moet u bellen EnsureMinimum om ontbrekende kindknooppunten aan te maken
Van HTML Kan een nieuwe tabel maken van HTML bron met tags als <table>, <tr>, <td> Niet allemaal mogelijk Microsoft Word tabelformaten kunnen worden toegepast op HTML
Een bestaande tabel klonen U kunt een kopie maken van een bestaande tabel met behoud van alle rij en celopmaak De juiste kindernodes moeten worden verwijderd voordat de tabel klaar is voor gebruik