การติดตั้ง

ตัวดู Doconut พื้นฐานสำหรับ .NET 6 มาพร้อมกับแพคเกจ NuGet เพียงหนึ่งที่สามารถเชื่อมต่อกับแอปพลิเคชัน ASP.NET Core ใดก็ได้ ปลั๊กอินเสริมใช้แพคเกจแยกต่างหาก หน้านี้ทำการติดตั้งแพคเกจพื้นฐานและลงทะเบียน middleware — ขั้นตอนขั้นต่ำที่จำเป็นก่อนการเรนเดอร์ครั้งแรกของคุณ.

ติดตั้งแพคเกจ

dotnet add package Doconut.NET6

คำสั่งที่ไม่มีเวอร์ชันจะติดตั้งรุ่นเสถียรล่าสุด เพื่อทำซ้ำรุ่น 26.7.0 ปัจจุบันอย่างแม่นยำ ให้ระบุเวอร์ชันเป็นตัวเลือกแยกต่างหาก:

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 คือ ID ของแพคเกจ ส่วนต่อท้าย .26.7.0 เป็นของไฟล์ Doconut.NET6.26.7.0.nupkg ที่ดาวน์โหลดและไม่ได้เป็นส่วนหนึ่งของ ID.

ระบุการรวมก่อนอัปเกรด

ID ของแพคเกจ Doconut.NET6 ถูกใช้ทั้งในการรวมแบบคลาสสิกและการรวมปัจจุบันของ .NET 6 อย่าเลือกเอกสารจากชื่อแพคเกจอย่างเดียว:

• DocImage.axd, new Viewer(_cache, _accessor, ...), synchronous OpenDocument(...), และสคริปต์ตัวดูที่คัดลอกด้วยตนเองระบุ การรวมแบบคลาสสิก;
• AddDoconut(), UseDoconutResources(), ตัว Viewer ที่ฉีดเข้า, และ OpenDocumentAsync(...) ระบุการรวมปัจจุบันที่อธิบายไว้ที่นี่.

คู่มือการตั้งค่าแบบคลาสสิกที่แปลแล้วยังคงพร้อมใช้งาน: คู่มือการตั้งค่าแบบคลาสสิก. ใช้ คู่มือการย้าย เพื่อเปลี่ยนรุ่น; การอัปเดตแพคเกจปกติจะไม่แปลงการเริ่มต้น, อายุการใช้งานของตัวดู, หรือทรัพยากรเบราว์เซอร์โดยอัตโนมัติ.

ลงทะเบียน Doconut

AddDoconut() เป็นจุดเข้าการลงทะเบียนเดียว — มี overload เพียงหนึ่งและจะเชื่อมต่อบริการ Viewer, บริการใบอนุญาต, และโครงสร้างพื้นฐานการเรนเดอร์เข้าไปในคอนเทนเนอร์ DI

การเรียก middleware สองครั้งจะทำให้การตั้งค่าเสร็จสมบูรณ์และลำดับของมันสำคัญ: UseDoconutResources() ต้องทำงานก่อน UseDoconut() UseDoconut() เป็น middleware สุดท้าย ดังนั้นการเรียกก่อนหมายความว่าคำขอทุกครั้งไปยังทรัพยากร /doconut-res จะไม่ถึงตัวจัดการทรัพยากรและจะคืนค่า 404 การเชื่อมต่อเซสชันก็จำเป็นเช่นกัน — ความปลอดภัยเอกสารเริ่มต้นของ Doconut ตรวจสอบทุกคำขอหน้าโดยอ้างอิงสถานะเซสชันของ ASP.NET

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // สถานะเซสชันต้องการแคช (MVC/Razor Pages ได้เพิ่มไว้แล้ว)
builder.Services.AddSession(); // ความปลอดภัยเอกสารของ Doconut ทำงานบนสถานะเซสชันของ ASP.NET

app.UseSession();          // เรียก UseSession() ก่อน UseDoconut()
app.UseDoconutResources(); // ต้องลงทะเบียนก่อน UseDoconut()
app.UseDoconut();

ตัวเลือกทั้งหมด

DoconutOptions รับคุณสมบัติที่สามารถตั้งค่าได้ต่อไปนี้ ทุกอย่างเป็นตัวเลือก — ค่าเริ่มต้นด้านล่างจะใช้เมื่อคุณสมบัติกระทำไม่ได้ตั้งค่า

ลำดับความสำคัญของใบอนุญาตเมื่อมีแหล่งมากกว่าหนึ่งตั้งค่า: LicenseStream แซง LicenseContent แซง LicensePath แซงการค้นหาอัตโนมัติ — ดูที่ การตั้งค่าใบอนุญาต.

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // ประสานกับการแมปของแอปและ BasePath ของไคลเอนต์
    options.ResourcesPath   = "/doconut-res"; // ที่ที่ JS/CSS/รูปภาพของตัวดูถูกให้บริการจาก
    options.UnsafeMode      = false;          // รักษาความปลอดภัยของเซสชันไว้
    options.ShowDoconutInfo = false;
});

ขั้นตอนต่อไป

• เริ่มต้นอย่างเร็ว — เปิดเอกสารแรกของคุณและเรนเดอร์ในเบราว์เซอร์
• การตั้งค่าใบอนุญาต — ที่ที่ Doconut มองหาไฟล์ใบอนุญาตของคุณ