---
title: "ภาพรวมตัวสร้างเอกสารใน C#"
---

[DocumentBuilder](https://reference.aspose.com/words/net/aspose.words/documentbuilder/) เป็นคลาสที่มีประสิทธิภาพซึ่งเชื่อมโยงกับ [Document](https://reference.aspose.com/words/net/aspose.words/document/) และช่วยให้คุณสร้างเอกสารแบบไดนามิกตั้งแต่เริ่มต้นหรือเพิ่มองค์ประกอบใหม่ให้กับเอกสารที่มีอยู่

**DocumentBuilder** มีวิธีแทรกข้อความ ช่องทำเครื่องหมาย วัตถุ ole ย่อหน้า รายการ ตาราง รูปภาพ และองค์ประกอบเนื้อหาอื่นๆ ช่วยให้คุณสามารถระบุแบบอักษร การจัดรูปแบบย่อหน้าหรือส่วน และดำเนินการอื่นๆ ได้

## เครื่องมือสร้างเอกสารหรือ Aspose.Words DOM

**DocumentBuilder** เสริมคลาสและวิธีการที่มีอยู่ใน Aspose.Words Document Object Model (DOM) เพื่อลดความซับซ้อนของงานสร้างเอกสารทั่วไป นั่นคือคุณสามารถสร้างและแก้ไขเนื้อหาของเอกสารทั้งผ่าน Aspose.Words DOM ซึ่งต้องมีความเข้าใจที่ดีเกี่ยวกับโครงสร้างต้นไม้และการใช้ DocumentBuilder `DocumentBuilder` เป็น "ส่วนหน้า" สำหรับโครงสร้าง **Document** ที่ซับซ้อนซึ่งช่วยให้คุณสามารถแทรกเนื้อหาและการจัดรูปแบบได้อย่างรวดเร็วและง่ายดาย

การดำเนินการที่เป็นไปได้ด้วย **DocumentBuilder** ก็สามารถทำได้เช่นกันเมื่อใช้คลาสของ Aspose.Words DOM โดยตรง อย่างไรก็ตาม การใช้คลาส Aspose.Words DOM โดยตรงมักต้องใช้โค้ดหลายบรรทัดมากกว่าการใช้ **DocumentBuilder**

## การนำทางเอกสาร

การนำทางเอกสารขึ้นอยู่กับแนวคิดของเคอร์เซอร์เสมือน ซึ่งคุณสามารถย้ายไปยังตำแหน่งอื่นในเอกสารโดยใช้วิธี **DocumentBuilder.MoveToXXX** ต่างๆ เช่น [MoveToDocumentStart](https://reference.aspose.com/words/net/aspose.words/documentbuilder/movetodocumentstart/) และ [MoveToField](https://reference.aspose.com/words/net/aspose.words/documentbuilder/movetofield/) เคอร์เซอร์เสมือนนี้ระบุตำแหน่งที่จะแทรกข้อความเมื่อเรียกใช้เมธอด [Write](https://reference.aspose.com/words/net/aspose.words/documentbuilder/write/), [Writeln](https://reference.aspose.com/words/net/aspose.words/documentbuilder/write/ln/index), [InsertBreak](https://reference.aspose.com/words/net/aspose.words/documentbuilder/insertbreak/) และอื่นๆ ดูบทความ "การนำทางด้วยเคอร์เซอร์" ต่อไปนี้เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับเคอร์เซอร์เสมือน

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการนำทางไปยังบุ๊กมาร์ก:

{{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Document-DocumentBuilderMovingCursor-DocumentBuilderMoveToBookmarkEnd.cs" >}}

## การสร้างและแก้ไขเอกสาร

Aspose.Words API มีหลายคลาสที่รับผิดชอบในการจัดรูปแบบองค์ประกอบต่างๆ ของเอกสาร แต่ละคลาสจะสรุปคุณสมบัติการจัดรูปแบบที่เกี่ยวข้องกับองค์ประกอบเอกสารเฉพาะ เช่น ข้อความ ย่อหน้า ส่วน และอื่นๆ ตัวอย่างเช่น คลาส [Font](https://reference.aspose.com/words/net/aspose.words/font/) แสดงถึงคุณสมบัติการจัดรูปแบบอักขระ คลาส [ParagraphFormat](https://reference.aspose.com/words/net/aspose.words/paragraphformat/) แสดงถึงคุณสมบัติการจัดรูปแบบย่อหน้า และอื่นๆ ออบเจ็กต์ของคลาสเหล่านี้จะถูกส่งกลับโดยคุณสมบัติ **DocumentBuilder** ที่สอดคล้องกัน ซึ่งมีชื่อเหมือนกับคลาส ดังนั้นคุณจึงสามารถเข้าถึงและตั้งค่าการจัดรูปแบบที่ต้องการระหว่างการสร้างเอกสารได้

คุณยังสามารถแทรกข้อความ กล่องกาเครื่องหมาย วัตถุ ole รูปภาพ ที่คั่นหน้า ช่องแบบฟอร์ม และองค์ประกอบเอกสารอื่นๆ ที่ตำแหน่งเคอร์เซอร์โดยใช้วิธี `Write` หรือวิธี **DocumentBuilder.InsertXXX** ใดๆ เช่น [InsertField](https://reference.aspose.com/words/net/aspose.words/documentbuilder/insertfield/#insertfield/), [InsertHtml](https://reference.aspose.com/words/net/aspose.words/documentbuilder/inserthtml/#inserthtml/) และวิธีการที่คล้ายกัน

มาดูวิธีสร้างเอกสารง่ายๆ โดยใช้ **DocumentBuilder** กัน

### สร้างเอกสารโดยใช้ DocumentBuilder

ในการเริ่มต้น คุณต้องสร้าง **DocumentBuilder** และเชื่อมโยงกับออบเจ็กต์ **Document** คุณสร้างอินสแตนซ์ใหม่ของ **DocumentBuilder** โดยการเรียกตัวสร้างและส่งไปยังออบเจ็กต์ **Document** เพื่อแนบไปกับตัวสร้าง

หากต้องการแทรกข้อความ ให้ส่งสตริงข้อความที่คุณต้องการแทรกลงในเอกสารไปยังวิธี **Write**

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างเอกสารอย่างง่ายโดยใช้ตัวสร้างเอกสาร

{{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Quick-Start-HelloWorld-HelloWorld.cs" >}}

### ระบุการจัดรูปแบบเอกสาร

คุณสมบัติ [Font](https://reference.aspose.com/words/net/aspose.words/documentbuilder/font/) กำหนดการจัดรูปแบบข้อความ ออบเจ็กต์นี้มีแอตทริบิวต์แบบอักษรที่แตกต่างกัน (ชื่อแบบอักษร ขนาดแบบอักษร สี และอื่นๆ) คุณลักษณะแบบอักษรที่สำคัญบางอย่างยังแสดงด้วยคุณสมบัติ **DocumentBuilder** เพื่อให้คุณสามารถเข้าถึงได้โดยตรง คุณสมบัติเหล่านี้คือคุณสมบัติบูลีน [Font.Bold](https://reference.aspose.com/words/net/aspose.words/font/bold/), [Font.Italic](https://reference.aspose.com/words/net/aspose.words/font/italic/) และ [Font.Underline](https://reference.aspose.com/words/net/aspose.words/font/underline/)

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการแทรกข้อความที่จัดรูปแบบโดยใช้ **DocumentBuilder**:

{{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Document-DocumentBuilderInsertParagraph-DocumentBuilderInsertParagraph.cs" >}}

```

- [Font](https://reference.aspose.com/words/net/aspose.words/documentbuilder/font/) ระบุการจัดรูปแบบอักขระที่จะใช้กับข้อความทั้งหมดที่แทรกจากตำแหน่งปัจจุบันในเอกสารเป็นต้นไป
- [ParagraphFormat](https://reference.aspose.com/words/net/aspose.words/paragraphformat/) ระบุการจัดรูปแบบย่อหน้าสำหรับย่อหน้าปัจจุบันและย่อหน้าทั้งหมดที่จะแทรก
- [PageSetup](https://reference.aspose.com/words/net/aspose.words/pagesetup/) ระบุคุณสมบัติของหน้าและส่วนสำหรับส่วนปัจจุบันและส่วนทั้งหมดที่จะแทรก
- [CellFormat](https://reference.aspose.com/words/net/aspose.words/documentbuilder/cellformat/) และ [RowFormat](https://reference.aspose.com/words/net/aspose.words/documentbuilder/rowformat/) ระบุคุณสมบัติการจัดรูปแบบที่จะใช้กับเซลล์ตารางและแถวจากตำแหน่งปัจจุบันในเอกสารเป็นต้นไป

ในสถานการณ์นี้ "ปัจจุบัน" หมายถึงตำแหน่ง ย่อหน้า ส่วน เซลล์ หรือแถวที่มีเคอร์เซอร์อยู่

```

```

โปรดทราบว่าคุณสมบัติ **Font**, **ParagraphFormat** และ **PageSetup** จะได้รับการอัปเดตทุกครั้งที่คุณนำทางไปยังตำแหน่งอื่นในเอกสารเพื่อแสดงคุณสมบัติการจัดรูปแบบของตำแหน่งนี้

```