การบูรณาการเข้ากับแอปพลิเคชันเว็บ ASP.NET Core ทำให้สามารถแก้ไขเอกสารได้อย่างราบรื่นโดยตรงในพอร์ทัลเว็บของคุณ. GroupDocs.Editor Cloud SDK for .NET ให้ API ที่ทรงพลังซึ่งช่วยให้คุณโหลด, แก้ไขและบันทึกไฟล์ DOCX บนเซิร์ฟเวอร์. คู่มือนี้จะพาคุณผ่านการตั้งค่าที่จำเป็น, แสดงโค้ดทีละขั้นตอน, และให้ตัวอย่างครบถ้วนที่คุณสามารถรันได้ในไม่กี่นาที. เมื่อเสร็จสิ้นคุณจะสามารถเพิ่มการแก้ไขเอกสารในแอปพลิเคชัน ASP.NET Core ได้อย่างมั่นใจ.

ข้อกำหนดเบื้องต้นและการตั้งค่า

ก่อนที่คุณจะเริ่ม, ตรวจสอบให้แน่ใจว่าคุณมีสิ่งต่อไปนี้:

  • ติดตั้ง .NET 6.0 SDK หรือเวอร์ชันที่ใหม่กว่า
  • IDE เช่น Visual Studio 2022 หรือ VS Code
  • บัญชี GroupDocs Cloud เพื่อรับ Client Id และ Client Secret
  • เข้าถึงเครื่องพัฒนา Windows, Linux หรือ macOS

การรวมเข้ากับแอปพลิเคชันเว็บ ASP.NET Core ยังต้องการการเชื่อมต่อเครือข่ายที่เชื่อถือได้กับจุดเชื่อมต่อของ GroupDocs Cloud เนื่องจากการประมวลผลเอกสารทั้งหมดเกิดขึ้นจากระยะไกล ควรวางแผนสภาพแวดล้อมการปรับใช้ของคุณให้เหมาะสม

ติดตั้ง SDK ผ่าน NuGet:

dotnet add package GroupDocs.editor-Cloud

ดาวน์โหลดแพ็กเกจล่าสุดจากหน้ารีลีสอย่างเป็นทางการ: GroupDocs.Editor Cloud SDK for .NET Download.

สร้างอ็อบเจ็กต์การกำหนดค่าโดยใช้ข้อมูลประจำตัวของคุณ (ส่วนย่อยจากตัวอย่างเต็ม):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

เมื่อทำการติดตั้งแพคเกจและเตรียมข้อมูลรับรองแล้ว คุณสามารถดำเนินการต่อไปสู่การใช้งานได้ ส่วนต่อไปนี้จะอธิบายโค้ดแต่ละส่วนอย่างละเอียด เพื่อให้คุณเข้าใจว่าไลบรารีนี้เข้ากับสถาปัตยกรรมโดยรวมของแอปพลิเคชันเว็บ ASP.NET Core อย่างไร

คู่มือแบบขั้นตอนในการรวมเข้ากับแอปพลิเคชันเว็บ ASP.NET Core

ส่วนนี้จะแบ่งกระบวนการผสานเข้ากับแอปพลิเคชันเว็บ ASP.NET Core ออกเป็นขั้นตอนย่อยที่จัดการได้ง่าย แต่ละขั้นตอนจะรวมโค้ดสั้น ๆ ที่นำมาจากการนำไปใช้เป็นอ้างอิงโดยตรง

ขั้นตอนที่ 1: กำหนดค่า API Credentials

ขั้นแรก ให้สร้างอ็อบเจกต์ Configuration ด้วยรายละเอียดของไคลเอนต์ของคุณและสร้างไคลเอนต์ EditorApi

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

EditorApi คลาสได้รับการบันทึกไว้ใน API reference. การเริ่มต้นไคลเอนต์หนึ่งครั้งต่อคำขอเพียงพอสำหรับสถานการณ์ส่วนใหญ่; คุณยังสามารถลงทะเบียนเป็น singleton ในคอนเทนเนอร์การฉีดพึ่งพา ASP.NET Core เพื่อประสิทธิภาพที่ดียิ่งขึ้น.

ขั้นตอนที่ 2: กำหนดตัวเลือกการโหลด

ระบุไฟล์ต้นทางและตำแหน่งที่ต้องการบันทึกผลลัพธ์โดยใช้ LoadOptions . อ็อบเจกต์นี้บอกบริการว่าเอกสารใดจะเปิดและจะเก็บ HTML ที่แปลงแล้วไว้ที่ไหน.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo และ RenderOptions ให้คุณควบคุมวิธีการแสดงผลเอกสารสำหรับการแก้ไข ตัวอย่างเช่น คุณสามารถตั้งค่า RenderOptions เพื่อรวมภาพ, รักษาสไตล์เดิม, หรือจำกัดจำนวนหน้าที่จะแสดงผล.

ขั้นตอนที่ 3: เรียกใช้ LoadDocument

เรียกใช้ API เพื่อโหลดและแปลงเอกสาร การเรียกใช้เป็นแบบ synchronous ในตัวอย่างนี้ แต่คุณก็สามารถใช้เวอร์ชัน asynchronous ได้หากการทำงานของ controller ของคุณเป็นแบบ async.

var loadResult = editorApi.LoadDocument(loadOptions);

LoadDocument เมธอดจะคืนค่าอ็อบเจ็กต์ผลลัพธ์ที่มี URL ไปยัง HTML ที่เรนเดอร์แล้วและเมตาดาต้าอื่น ๆ คุณสามารถเก็บ loadResult ไว้สำหรับการดึงข้อมูลในภายหลังหรือส่ง HTML โดยตรงไปยัง front‑end

ขั้นตอนที่ 4: ประมวลผลผลการโหลด

หลังจากโหลดแล้ว คุณสามารถให้บริการ HTML ไปยัง front‑end หรือเก็บไว้ใช้ในภายหลัง ขั้นตอนนี้ทำให้การ รวมตัวแก้ไขเอกสารเข้ากับแอปเว็บ ASP.NET Core เสร็จสมบูรณ์และเตรียมเอกสารสำหรับการโต้ตอบของผู้ใช้.

ในสถานการณ์จริงคุณมักจะส่งคืนเนื้อหา HTML จากการกระทำของคอนโทรลเลอร์:

return Content(loadResult.HtmlContent, "text/html");

คุณอาจต้องการใช้การแคชเพื่อหลีกเลี่ยงการโหลดเอกสารเดียวกันซ้ำหลายครั้ง ซึ่งสามารถปรับปรุงเวลาในการตอบสนองเมื่อ การรวมเข้ากับเว็บแอปพลิเคชัน ASP.NET Core ในระดับใหญ่.

การรวม Document Editor เข้ากับแอปพลิเคชันเว็บ ASP.NET Core - ตัวอย่างโค้ดเต็ม

โค้ดต่อไปนี้แสดงกระบวนการทั้งหมดตั้งแต่การกำหนดค่าไปจนถึงการโหลดไฟล์ DOCX

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบและอัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบให้แน่ใจว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การใช้ cURL สำหรับการรวมการแก้ไขเอกสาร ASP.NET Core

หากคุณต้องการใช้วิธี REST โดยตรง คุณสามารถทำการดำเนินการเดียวกันด้วยคำสั่ง cURL ได้ วิธีนี้มีประโยชน์สำหรับการสร้างต้นแบบอย่างรวดเร็วหรือเมื่อคุณต้องการรวมตัวแก้ไขเข้ากับบริการที่ไม่ได้เขียนด้วย .NET

1. ตรวจสอบและรับโทเค็นการเข้าถึง

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

การตอบสนองมี access_token ที่ใช้ในการเรียกต่อไป

2. อัปโหลดไฟล์ต้นฉบับ

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. โหลดเอกสารเพื่อแก้ไข

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. ดาวน์โหลด HTML ที่เรนเดอร์แล้ว

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

คำสั่งเหล่านี้แสดงให้เห็นวิธี เพิ่มการแก้ไขเอกสารในแอปพลิเคชัน ASP.NET Core โดยไม่ต้องเขียนโค้ด C# ใด ๆ ซึ่งเป็นประโยชน์สำหรับการทดสอบอย่างรวดเร็วหรือการรวมกับบริการอื่น ๆ สำหรับรายละเอียดเพิ่มเติม ดูที่ เอกสาร API อย่างเป็นทางการ.

โดยการเชี่ยวชาญทั้งไลบรารี .NET และ REST API ดิบ คุณจะได้รับความยืดหยุ่นเมื่อ รวมเข้ากับเว็บแอปพลิเคชัน ASP.NET Core ซึ่งทำให้คุณสามารถเลือกวิธีที่เหมาะสมที่สุดกับสถาปัตยกรรมของคุณได้.

FAQs

การอ่านเพิ่มเติม