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.
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:
Das folgende Codebeispiel zeigt, wie man die letzte Zeile einer Tabelle klont und an die Tabelle angibt:
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 |