نمایشگر سند برای ASP.NET Core و .NET Standard
۱۴۰۲/۵/۲۱

نمایشگر سند برای ASP.NET Core و .NET Standard

کدام زمان‌های اجرا (runtime) نمایشگر Doconut هدف‌گیری می‌کند، کجا اجرا می‌شود، مرورگر چه چیزی باید نصب کند، و سرور به جای آن چه کاری انجام می‌دهد. حقایق، نه یک صفحه فروش.

نمایشگری که این سایت را اجرا می‌کند یک مؤلفه بومی .NET است. در پروژهٔ خود شما این یک مرجع است، نه سرویسی که به آن فراخوانی می‌کنید. دو هدف ساخت وجود دارد: .NET Framework 4.0 و بالاتر، و .NET Standard 2.0 و بالاتر، که باعث می‌شود این مؤلفه داخل .NET Core و تمام نسخه‌های بعدی قرار گیرد. این مؤلفه داکونوت است.

نمایشگر سند ASP.NET CORE | .NET STANDARD
نمایشگر سند ASP.NET CORE | .NET STANDARD

هدفی که انتخاب کرده‌اید

بر اساس آنچه پروژه فعلاً است انتخاب کنید، نه بر پایهٔ اینکه کدام یک جدیدتر به نظر می‌رسد.

  • WebForms یا MVC روی .NET Framework — هدف 4.0+. هیچ تغییری لازم نیست.
  • ASP.NET Core MVC یا Razor Pages — هدف .NET Standard 2.0.
  • Blazor Server — همان هدف .NET Standard 2.0. رندرینگ به هر حال روی سرور انجام می‌شود، بنابراین مدل میزبانی تغییری در نیازهای مؤلفه ایجاد نمی‌کند.
  • کانتینرهای لینوکس — پشتیبانی می‌شود. این مسیر .NET Core است، در یک کانتینر.

هر دو هدف از یک رندرکنندهٔ یکسان استفاده می‌کنند. هدف تعیین می‌کند که کدام اسمبلی را ارجاع می‌دهید، نه اینکه چه قالب‌هایی در دسترس هستند.

چه چیزی مرورگر نصب می‌کند

هیچ‌چیز. هیچ ActiveX، افزونه، Java یا ریدری نیست. سرور سند را به شکلی تبدیل می‌کند که مرورگر از قبل می‌داند چگونه آن را رسم کند و آن را می‌فرستد. به همین دلیل است که نمایشگر همان‌طور بر روی یک دسکتاپ شرکتی قفل‌شده همانند یک تلفن رفتار می‌کند: هیچ‌چیزی بر روی کلاینت وجود ندارد که مفقود یا قدیمی باشد.

سرور به جای آن چه کاری انجام می‌دهد

همه چیز. سند باز می‌شود، چیدمان می‌شود و روی دستگاه شما رندر می‌شود، که دو پیامد مهم دارد که باید برایشان برنامه‌ریزی کنید.

  • نیازی به Office روی سرور نیست. رندرکننده بومی .NET است و قالب‌ها را به‌صورت مستقیم می‌خواند. نیازی به نصب Office، Interop یا COM نیست.
  • رندرینگ مصرف CPU و حافظه بر روی دستگاه شما دارد. یک PDF ۲۰۰ صفحه‌ای و یک نقشه CAD ۴۰ مگابایتی درخواست‌های یکسانی نیستند. ماشین را برای بزرگ‌ترین فایلی که واقعاً می‌خواهید بپذیرید، مقیاس‌بندی کنید و حجم بارگذاری‌ها را در همان حد تنظیم کنید.

آنچه نیست

این یک کتابخانهٔ JavaScript سمت کلاینت نیست که فایل‌ها را در مرورگر باز می‌کند، و همچنین یک API میزبانی‌شده برای ارسال اسناد نیست. اگر به هر یک از این‌ها نیاز دارید، این مؤلفه اشتباه است و بهتر است از ابتدا این موضوع را بدانید.

آیا می‌خواهید خروجی را قبل از ارجاع به هر چیزی ببینید؟ این همان رندرکننده‌ای است که پشت نمایشگر این سایت قرار دارد — یک فایل را بارگذاری کنید و همان چیزی که کاربران شما دریافت می‌کنند، خواهد بود. مجوزها، بسته‌ها و مستندات API در داکونوت.com موجود هستند.