Eine Tabelle erstellen

Aspose.Words ermöglicht es Benutzern, Tabellen in einem Dokument von Grund auf zu erstellen und bietet mehrere verschiedene Methoden dafür. Dieser Artikel enthält Details, wie Sie formatierte Tabellen mit jeder Methode zu Ihrem Dokument hinzufügen, sowie einen Vergleich jeder Methode am Ende des Artikels.

Standard Tisch Stile

Die neu erstellte Tabelle enthält Standardwerte, die den in Microsoft Word:

Tabelle Immobilien	Standard Aspose.Words
Border Style	Single
Border Width	1/2 pt
Grenzfarbe	Black
Left and Right Padding	5.4 pts
AutoFit Mode	AutoFit to Window
Allow AutoFit	True
Eine Tabelle kann inline sein, wenn sie fest positioniert ist, oder schwimmen, wenn sie irgendwo auf der Seite positioniert werden kann. Standardmäßig, Aspose.Words erstellt immer Inline-Tabellen.

Erstellen Sie eine Tabelle mit DocumentBuilder

In Aspose.Words, Benutzer können eine Tabelle in einem Dokument mit dem DocumentBuilder. Der Grundalgorithmus zur Erstellung einer Tabelle ist wie folgt:

ANHANG Starten Sie die Tabelle mit StartTable 2. Hinzufügen einer Zelle zur Tabelle mit InsertCell – dies startet automatisch eine neue Zeile 3. Optional verwenden Sie die CellFormat Eigenschaft zur Angabe der Zellformatierung 4. Fügen Sie den Zellinhalt mit der entsprechenden DocumentBuilder Methoden wie Writeln, InsertImage, und andere 5. Wiederholen Sie die Schritte 2-4, bis die Zeile vollständig ist 6. Anruf EndRow um die aktuelle Zeile zu beenden 7. Optional verwenden Sie die RowFormat Eigenschaft zur Angabe der Zeilenformatierung 8. Wiederholen Sie die Schritte 2-7, bis die Tabelle vollständig ist 9. Anruf EndTable um den Tisch zu fertigen

Wichtige Details:

• Ja. StartTable kann auch innerhalb einer Zelle aufgerufen werden, wobei sie die Erstellung eines geschachtelten Tisches innerhalb der Zelle beginnt.
• Nach dem Anruf InsertCell, eine neue Zelle erstellt wird, und alle Inhalte, die Sie mit anderen Methoden der DocumentBuilder die Klasse wird der aktuellen Zelle hinzugefügt. Um eine neue Zelle in derselben Zeile zu erstellen, rufen Sie an InsertCell wieder.
• Wenn InsertCell wird sofort nachgeschaltet EndRow und das Ende einer Reihe, wird die Tabelle auf einer neuen Reihe fortsetzen.
• Die EndTable Verfahren zum Ende der Tabelle sollte nur einmal nach dem Aufruf aufgerufen werden EndRow. Anruf EndTable bewegt den Cursor von der aktuellen Zelle in die Position unmittelbar nach der Tabelle.

Der Prozess der Erstellung einer Tabelle ist im folgenden Bild deutlich zu erkennen:

Das folgende Codebeispiel zeigt, wie eine einfache Tabelle mit DocumentBuilder mit Standardformatierung:

Das folgende Codebeispiel zeigt, wie eine formatierte Tabelle mit DocumentBuilder erstellt werden kann:

Das folgende Codebeispiel zeigt, wie eine geschachtelte Tabelle mit DocumentBuilder eingefügt werden kann:

Eine Tabelle erstellen DOM (Document Object Model)

Sie können Tabellen direkt in die DOM durch Hinzufügen eines neuen Table Knoten an einer bestimmten Position.

Bitte beachten Sie, dass unmittelbar nach der Erstellung des Tabellenknotens die Tabelle selbst vollständig leer ist, d.h. sie enthält noch keine Zeilen und Zellen. Um Zeilen und Zellen in eine Tabelle einzufügen, fügen Sie die entsprechende Row und Cell Kinderknoten zu den DOM.

Diese Methode der Erstellung einer Tabelle verwendet die gleichen Tabelleneinstellungen wie bei der Verwendung der DocumentBuilder.

Das folgende Codebeispiel zeigt, wie eine neue Tabelle von Grund auf erstellt werden kann, indem die entsprechenden Child-Nodes in den Dokumentenbaum eingefügt werden:

Eine Tabelle aus HTML erstellen

Aspose.Words unterstützt das Einfügen von Inhalten in ein Dokument aus einer HTML-Quelle mithilfe der InsertHtml Methode. Die Eingabe kann eine volle HTML-Seite oder nur ein Teil-Snippet sein.

Verwenden Sie diese InsertHtml Verfahren, Benutzer können Tabellen in das Dokument über Tabellen-Tags wie <table>, <tr>, <td>.

Das folgende Codebeispiel zeigt, wie eine Tabelle in ein Dokument aus einem String mit HTML-Tags eingefügt werden kann:

Fügen Sie ein Exemplar einer vorhandenen Tabelle ein

Es gibt oft Zeiten, in denen Sie eine Tabelle basierend auf einer bereits vorhandenen Tabelle in einem Dokument erstellen müssen. Der einfachste Weg, eine Tabelle unter Beibehaltung aller Formatierung zu duplizieren ist, den Tabellenknoten mit dem deepClone Methode.

Die gleiche Technik kann verwendet werden, um Kopien einer vorhandenen Zeile oder Zelle zu einer Tabelle hinzuzufügen.

Das folgende Codebeispiel zeigt, wie man eine Tabelle mit Knotenkonstruktoren dupliziert:

Sie können die Beispieldatei dieses Beispiels herunterladen Aspose.Words GitHub.

Das folgende Codebeispiel zeigt, wie man die letzte Zeile einer Tabelle klont und an die Tabelle angibt:

Sie können die Beispieldatei dieses Beispiels herunterladen Aspose.Words GitHub.

Wenn Sie die Erstellung von Tabellen in einem Dokument betrachten, die dynamisch mit jedem Datensatz aus Ihrer Datenquelle wachsen, wird die obige Methode nicht empfohlen. Vielmehr wird die gewünschte Leistung durch die Verwendung leichter erreicht Mail merge mit Regionen. Sie können mehr über diese Technik in der Mail Merge mit den Regionen Abschnitt.

Vergleichen Sie Wege, eine Tabelle zu erstellen

Aspose.Words bietet mehrere Methoden, um neue Tabellen in einem Dokument zu erstellen. Jedes Verfahren hat eigene Vor- und Nachteile, deren Wahl oft von der konkreten Situation abhängt.

Lassen Sie uns einen genaueren Blick auf diese Weise der Erstellung von Tabellen und vergleichen ihre Vor- und Nachteile:

Methode	Vorteile	Nachteile
Via DocumentBuilder	Das Standardverfahren zum Einfügen von Tabellen und anderen Dokumenteninhalten	Manchmal schwierig, viele Arten von Tischen gleichzeitig mit der gleichen Builder-Instanz zu schaffen
Via DOM	Passt besser mit Umgebungscode, der Knoten direkt in den DOM ohne Verwendung von DocumentBuilder	Die Tabelle wird “leer” erstellt: Bevor Sie die meisten Operationen durchführen, müssen Sie anrufen EnsureMinimum um fehlende Kinderknoten zu erstellen
Von HTML	Kann eine neue Tabelle aus HTML-Quelle mit Tags wie erstellen <table>, <tr>, <td>	Nicht alle möglich Microsoft Word Tabellenformate können auf HTML angewendet werden
Schließung einer bestehenden Tabelle	Sie können eine Kopie einer vorhandenen Tabelle erstellen, während Sie alle Zeilen- und Zellformatierung beibehalten	Die entsprechenden Kinderknoten müssen entfernt werden, bevor die Tabelle gebrauchsfertig ist