ویور فایل اکسل – نمایش داده‌های اکسل با استفاده از C#

ما می‌توانیم داده‌ها را از فایل‌های اکسل به‌صورت برنامه‌نویسی در قالب HTML، PDF یا به‌عنوان یک تصویر در برنامه‌های .NET نمایش دهیم. این امکان را فراهم می‌کند که داده‌ها را به دیگران نشان دهیم بدون اینکه فایل‌های اکسل واقعی را به اشتراک بگذاریم. در این مقاله، یاد می‌گیریم که چگونه یک نمایشگر فایل اکسل ایجاد کنیم و داده‌های اکسل را با استفاده از C# نمایش دهیم.

موضوعات زیر در این مقاله پوشش داده خواهند شد:

API مشاهده فایل Excel C# — دانلود رایگان

برای نمایش داده‌ها از XLS یا XLSX جداول، ما از API GroupDocs.Viewer for .NET استفاده خواهیم کرد. این API امکان رندر و مشاهده فرمت‌های جداول پشتیبانی شده را به‌طور برنامه‌نویسی فراهم می‌کند. لطفاً یا دانلود DLL این API را انجام دهید یا آن را با استفاده از NuGet نصب کنید.

PM> Install-Package GroupDocs.Viewer

نمایش داده‌های Excel در HTML با استفاده از C#

ما می‌توانیم فایل اکسل را رندر کنیم و داده‌ها را در HTML با دنبال کردن مراحل ساده زیر نمایش دهیم:

  1. Firstly, load an Excel file using the Viewer class.
  2. یک نمونه از کلاس HtmlViewOptions برای EmbeddedResourcesایجاد کنید.
  3. مسیر فایل خروجی را به عنوان یک آرگومنت ارائه دهید.
  4. اختیاری، گزینه‌های نمایشی مختلفی را تنظیم کنید، مانند RenderToSinglePage.
  5. سرانجام، متد View() را صدا بزنید و HtmlViewOptions را به عنوان یک آرگومان منتقل کنید.

کد نمونه زیر نشان می‌دهد که چگونه یک فایل Excel را در HTML با استفاده از C# نمایش دهیم.

// این مثال کد نشان می‌دهد که چگونه فایل اکسل را در HTML رندر کنیم.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// تنظیمات نمایش HTML را تعریف کنید
HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources(@"C:\Files\Viewer\sample_output.html");
viewOptions.RenderToSinglePage = true;

// Render view
viewer.View(viewOptions);
نمایش داده‌های اکسل در HTML با استفاده از C# .

نمایش داده‌های Excel در HTML با استفاده از C#.

داده‌های اکسل را با استفاده از C# به PDF تبدیل کنید

ما می‌توانیم فایل اکسل را ارائه کنیم و داده‌ها را در PDF نمایش دهیم با پیروی از مراحل زیر:

  1. Firstly, load an Excel file using the Viewer class.
  2. یک نمونه از کلاس PdfViewOptions را ایجاد کنید.
  3. مسیر فایل خروجی را به عنوان یک آرگومنت ارائه دهید.
  4. در نهایت، متد View() را فراخوانی کنید و PdfViewOptions را به عنوان یک آرگومان پاس دهید.

کد نمونه زیر نشان می‌دهد که چگونه یک فایل Excel را با استفاده از C# در PDF رندر کنیم.

// این مثال کد نشان می‌دهد که چگونه فایل اکسل را در PDF رندر کنیم.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// گزینه‌های مشاهده PDF را تعریف کنید
PdfViewOptions viewOptions = new PdfViewOptions(@"C:\Files\Viewer\sample_output.pdf");

// View
viewer.View(viewOptions);
Excel داده‌ها را با استفاده از C# به PDF تبدیل کنید.

Excel داده‌ها را در PDF با استفاده از C# رندر کنید.

فایل اکسل را به عنوان تصویر JPG با استفاده از C# مشاهده کنید

ما می‌توانیم فایل این اکسل را نمایش دهیم و داده‌ها را به‌عنوان تصاویر JPG نشان دهیم با دنبال کردن مراحل زیر:

  1. Firstly, load an Excel file using the Viewer class.
  2. یک نمونه از کلاس JpgViewOptions ایجاد کنید.
  3. Provide the output file path.
  4. در نهایت، متد View() را فراخوانی کرده و JpgViewOptions را به عنوان یک آرگومان ارسال کنید.

کد نمونه زیر نشان می‌دهد که چگونه یک فایل Excel را به صورت JPG با استفاده از C# رندر کنیم.

// این مثال کد نشان می‌دهد که چگونه فایل Excel را در تصویر JPG رندر کنیم.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// تنظیمات نمایش JPG را تعریف کنید
JpgViewOptions viewOptions = new JpgViewOptions(@"C:\Files\Viewer\sample_output.jpg");

// View
viewer.View(viewOptions);
فایل اکسل را به عنوان تصویر JPG با استفاده از C# مشاهده کنید.

نمایش فایل اکسل به عنوان تصویر JPG با استفاده از C# .

به طور مشابه، ما می‌توانیم یک فایل اکسل را به تصاویر PNG تبدیل کنیم همان‌طور که در زیر نشان داده شده است:

// این مثال کد نحوه رندر کردن فایل اکسل به تصویر PNG را نشان می‌دهد.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// گزینه‌های مشاهده PNG را تعریف کنید
PngViewOptions viewOptions = new PngViewOptions(@"C:\Files\Viewer\sample_output.png");

// View
viewer.View(viewOptions);

تعدیل سرریز متن در سلول‌ها با استفاده از C#

ما می‌توانیم overflow متن را در سلول‌ها در حین رندر کردن یک صفحه‌کار Excel تنظیم کنیم. API انواع زیر از تنظیمات overflow را ارائه می‌دهد:

  • Overlay – overlay سلول های بعدی حتی اگر خالی نباشند.
  • OverlayIfNextIsEmpty – فقط در صورتی که سلول‌های بعدی خالی باشند، روی آن‌ها پوشش بگذارید.
  • AutoFitColumn – گسترش ستون‌ها برای متناسب شدن با متن.
  • HideText – پنهان کردن متن اضافی.

لطفاً مراحل زیر را برای تنظیم overflow متن دنبال کنید:

  1. Firstly, load an Excel file using the Viewer class.
  2. Create an instance of PdfViewOptions class
  3. Provide the output file path.
  4. خصوصیت TextOverflowMode را در SpreadsheetOptions به HideText تنظیم کنید.
  5. اختیاری است که RenderHeadings و RenderGridLines را به true تنظیم کنید.
  6. Finally, call the View() method and pass PdfViewOptions as an argument.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان overflow متن را در هنگام رندر کردن یک فایل Excel با استفاده از C# تنظیم کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان برش متن را در یک سلول تنظیم کرد، سرصفحه‌ها و خطوط شبکه را رندر کرد.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// گزینه‌های مشاهده PDF را تعریف کنید
PdfViewOptions viewOptions = new PdfViewOptions(@"C:\Files\Viewer\sample_overflow.pdf");

// متن Overflow را تنظیم کنید
viewOptions.SpreadsheetOptions.TextOverflowMode = TextOverflowMode.HideText;

// Render Excel headings
viewOptions.SpreadsheetOptions.RenderHeadings = true;

// خطوط شبکه را ترسیم کنید
viewOptions.SpreadsheetOptions.RenderGridLines = true;

// View
viewer.View(viewOptions);
سلول‌ها را با استفاده از C# تنظیم کنید تا متون اضافی برش خورده و overflow شوند.

برنامه‌ریزی در مورد Overflow متن در سلول‌ها با استفاده از C#.

رندر سطرها و ستون‌های مخفی اکسل

می‌توانیم ردیف‌ها و ستون‌های پنهان یک کاربرگ اکسل را با پیروی از مراحل ذکر شده در بالا ارائه دهیم. با این حال، ما فقط نیاز داریم تا ویژگی‌های زیر را در مرحله # ۴ به true تنظیم کنیم:

viewOptions.SpreadsheetOptions.RenderHiddenColumns = true;
viewOptions.SpreadsheetOptions.RenderHiddenRows = true;

کد نمونه زیر نشان می‌دهد چگونه می‌توان ردیف‌ها و ستون‌های پنهان یک فایل Excel را در PDF با استفاده از C# نمایش داد.

// این مثال کد نشان می‌دهد که چگونه ردیف‌ها و ستون‌های مخفی صفحه Excel را باز-render کنیم.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// تنظیمات نمایشی PDF را تعریف کنید
PdfViewOptions viewOptions = new PdfViewOptions(@"C:\Files\Viewer\hidden_rows_columns.pdf");
viewOptions.SpreadsheetOptions.RenderHiddenColumns = true;
viewOptions.SpreadsheetOptions.RenderHiddenRows = true;

// View
viewer.View(viewOptions);
رندر ردیف‌ها و ستون‌های پنهان اکسل.

ردیف‌ها و ستون‌های مخفی اکسل را نمایش دهید.

رد شدن از سطرها و ستون های خالی در اکسل با استفاده از سی شارپ

ما می‌توانیم هنگام مشاهده برگه اکسل، رندر کردن سطرها و ستون‌های خالی را با دنبال کردن مراحل ذکر شده در بالا نادیده بگیریم. با این حال، ما فقط نیاز داریم که خواص زیر را در مرحله # ۴ به true تنظیم کنیم:

viewOptions.SpreadsheetOptions.SkipEmptyColumns = true;
viewOptions.SpreadsheetOptions.SkipEmptyRows = true;

نمونه کد زیر نشان می‌دهد که چگونه می‌توان از رندر کردن ردیف‌ها و ستون‌های خالی یک فایل Excel با استفاده از C# صرف نظر کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان رندر کردن ردیف‌ها و ستون‌های پنهان در شیت اکسل را نادیده گرفت.
// Load the Excel file
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

// تنظیمات نمایش PDF را تعریف کنید
PdfViewOptions viewOptions = new PdfViewOptions(@"C:\Files\Viewer\skip_empty.pdf");
viewOptions.SpreadsheetOptions.SkipEmptyColumns = true;
viewOptions.SpreadsheetOptions.SkipEmptyRows = true;

// View
viewer.View(viewOptions);
رادیکال کردن سطرها و ستون‌های خالی در اکسل با استفاده از C#

ر row های خالی و ستون های خالی را در اکسل با استفاده از C# رد کنید.

ورق اکسل را بر اساس ردیف‌ها و ستون‌ها تقسیم کنید

ما می‌توانیم کاربرگ‌های بزرگ Excel را رندر کنیم و آنها را بر اساس تعداد ردیف‌ها و ستون‌ها در یک صفحه تقسیم کنیم. ما می‌توانیم کاربرگ را با دنبال کردن مراحل زیر تقسیم کنیم:

  1. Firstly, load an Excel file using the Viewer class.
  2. Create an instance of PdfViewOptions class
  3. Provide the output file path.
  4. SpreadsheetOptions را با استفاده از روش ForSplitSheetIntoPages مقداردهی کنید. این متد تعداد ردیف‌ها و ستون‌ها در هر صفحه را به عنوان آرگومان می‌گیرد.
  5. در نهایت، متد View() را صدا بزنید و PdfViewOptions را به عنوان یک آرگومان بگذرانید.

کد نمونه زیر نشان می‌دهد که چگونه یک برگه اکسل را با استفاده از C# به صورت سطرها و ستون‌ها تقسیم کنیم.

// این مثال کد نشان می‌دهد که چگونه می‌توان یک برگه Excel را بر اساس ردیف‌ها و ستون‌ها تقسیم کرد.
// فایل اکسل را بارگذاری کنید
Viewer viewer = new Viewer(@"C:\Files\Viewer\sample.xlsx");

int countRowsPerPage = 25;
int countColumnsPerPage = 5;

PdfViewOptions viewOptions = new PdfViewOptions(@"C:\Files\Viewer\sample_split.pdf");
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForSplitSheetIntoPages(countRowsPerPage, countColumnsPerPage);

viewer.View(viewOptions);
تقسیم شیت اکسل بر اساس ردیف‌ها و ستون‌ها

Split Excel Worksheet by Rows and Columns.

یک مجوز رایگان بگیرید

لطفاً با درخواست a free temporary license آزمایش کنید که بدون محدودیت های ارزیابی از API استفاده کنید.

نتیجه‌گیری

در این مقاله، ما یاد گرفتیم که چگونه:

  • render or view Excel worksheets in HTML, PDF, PNG, and JPG using C#;
  • متن overflow را در سلول‌های Excel تنظیم کنید و خطوط شبکه را نمایش دهید؛
  • display headings of Excel columns and rows;
  • skip empty rows/columns and show hidden rows and columns;
  • limit display of worksheets by rows and columns.

علاوه بر این، می‌توانید اطلاعات بیشتری درباره GroupDocs.Viewer برای API .NET با استفاده از documentation یاد بگیرید. در صورت هر گونه ابهام، لطفاً احساس راحتی کنید و با ما در forum تماس بگیرید.

به همچنین نگاهی بیندازید