رایج ترین و پرکاربردترین فرمت های فایل صفحه گسترده XLS، XLSX و ODS هستند. Microsoft Excel و OpenOffice Calc معروف از این فرمت ها پشتیبانی می کنند و ما معمولا از این فرمت ها برای نگهداری حساب ها و صفحات گسترده مختلف استفاده می کنیم. بنابراین، بهعنوان یک توسعهدهنده، بهطور گستردهای نیاز داریم که فایلهای اکسل را در برنامههای خود بهصورت برنامهنویسی ویرایش کنیم. در این مقاله به نحوه ویرایش فایل های اکسل در C# با استفاده از NET API می پردازیم.
موضوعات زیر به طور خلاصه در این مقاله مورد بحث قرار گرفته است:
NET API برای ویرایش و اتوماسیون صفحات گسترده اکسل
GroupDocs .NET API را برای ویرایش صفحه گسترده به نمایش می گذارد. من از آن در نمونه های C# این مقاله استفاده خواهم کرد. این API ویرایش اسناد است و به توسعه دهندگان اجازه می دهد تا فرمت های اسناد مختلف را با استفاده از ویرایشگرهای WYSIWYG HTML بارگیری، ویرایش و ذخیره کنند. علاوه بر فرمتهای صفحه گسترده XLS، XLSX و ODS، API از ویرایش سایر صفحهگستردهها و فرمتهای پشتیبانیشده MS Excel پشتیبانی میکند. مانند CSV، TSV، DSV، XLT، XLTX، XLTM، XLSM، XLSB، XLAM، SXC، صفحه گستردهML، FODS، DIF.
نصب کننده DLL یا MSI را از بخش دانلودها دانلود کنید یا API را از طریق NuGet در برنامه .NET خود نصب کنید. /packages/groupdocs.editor).
PM> Install-Package GroupDocs.Editor
ویرایش فایل های اکسل در C#
امیدواریم با موفقیت به API ارجاع داده باشید. اکنون می توانید به سرعت ویرایش اسناد اکسل خود را شروع کنید. مراحل زیر به شما امکان می دهد اسناد صفحه گسترده را با استفاده از C# ویرایش کنید.
- فایل اکسل را بارگیری کنید.
- مطابق با گزینه ها ویرایش کنید.
- سند ویرایش شده را ذخیره کنید.
صفحه گسترده اکسل را بارگیری کنید
ابتدا، صفحه گسترده را با ارائه مسیر/جریان سند و رمز عبور (اگر سند دارای رمز عبور محافظت شده است) بارگیری کنید.
// بارگیری فایل اکسل با استفاده از سی شارپ
Options.SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.Password = "password"; // if any
// صفحه گسترده را بارگیری کنید
Editor editor = new Editor("path/spreadsheet.xlsx", delegate { return loadOptions; });
فایل اکسل را ویرایش کنید
پس از بارگذاری، می توانید صفحه گسترده بارگذاری شده را در صورت نیاز ویرایش کنید. اکنون در تب اول صفحه گسترده میخواهیم همه موارد «نام شرکت قدیمی» را با «نام شرکت جدید» جایگزین کنیم. مراحل زیر به شما امکان می دهد فایل اکسل را مطابق با C# ویرایش کنید.
- فایل اکسل را با استفاده از Editor و گزینههای بارگیری بارگیری کنید .editor.options/spreadsheetloadoptions).
- گزینه های ویرایش صفحه گسترده را برای استخراج برگه/برگه دقیق آماده کنید.
- استخراج کردن the content of the tab.
- محتوای برگه را اصلاح کنید.
- می توانید تصاویر و تمام منابع را از برگه انتخاب شده استخراج کنید.
- EditableDocument جدید را با استفاده از محتوای اصلاح شده ایجاد کنید.
- صفحه گسترده ویرایش را با استفاده از روش مناسب Save() ذخیره کنید.
کد منبع C# زیر فایل اکسل را ویرایش و محتوای آن را تغییر می دهد.
// ویرایش صفحه گسترده اکسل با استفاده از سی شارپ
Options.SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// loadOptions.Password = "رمز عبور";
// صفحه گسترده را بارگیری کنید
Editor editor = new Editor("path/spreadsheet.xlsx", delegate { return loadOptions; });
// برگه اول صفحه گسترده را دریافت کنید
SpreadsheetEditOptions sheetTab1EditOptions = new SpreadsheetEditOptions();
sheetTab1EditOptions.WorksheetIndex = 0; // first worksheet
// نشانه گذاری HTML را از برخی از نمونه های EditableDocument دریافت کنید
EditableDocument firstTab = editor.Edit(sheetTab1EditOptions);
string bodyContent = firstTab.GetBodyContent(); // HTML markup from inside the HTML ->BODY element
string allContent = firstTab.GetContent(); // Full HTML markup of all document, with HTML ->HEAD header and all its content
List<IImageResource> onlyImages = firstTab.Images;
List<IHtmlResource> allResourcesTogether = firstTab.AllResources;
string editedContent = allContent.Replace("Company Name", "New Company Name");
EditableDocument afterEdit = EditableDocument.FromMarkup(editedContent, allResourcesTogether);
فایل اکسل ویرایش شده را با گزینه ها ذخیره کنید
پس از ویرایش، هنگام ذخیره محتوای صفحه گسترده ویرایش شده، می توانید گزینه های مختلفی را تنظیم کنید. این گزینه ها عبارتند از تنظیم رمز عبور، فرمت خروجی، حفاظت و غیره. من گزینه های بالا را در کد زیر تنظیم می کنم و صفحه گسترده ویرایش شده را به عنوان یک فایل XLSX محافظت شده با رمز عبور و محافظت از نوشتن ذخیره می کنم.
// فایل اکسل را با محتوای به روز شده با استفاده از C# ذخیره کنید
// گزینه های ذخیره را ایجاد کنید
SpreadsheetFormats xlsxFormat = SpreadsheetFormats.Xlsx;
Options.SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
// رمز ورود جدید را تنظیم کنید
saveOptions.Password = "newPassword";
saveOptions.WorksheetProtection = new WorksheetProtection(WorksheetProtectionType.All, "WriteProtectionPassword");
// جریان خروجی ایجاد کنید
using (FileStream outputStream = File.Create("path/editedSpreadsheet.xlsx"))
{
editor.Save(afterEdit, outputStream, saveOptions);
}
مجوز رایگان دریافت کنید
برای استفاده از API بدون محدودیت ارزیابی، می توانید یک مجوز موقت رایگان دریافت کنید.
نتیجه
برای نتیجه گیری، نحوه ویرایش اسناد اکسل در C# با استفاده از API ویرایش اسناد برای برنامه های NET را مورد بحث قرار دادیم. می توانید از API با ویرایشگرهای WYSIWYG برای ویرایش بصری اسناد خود استفاده کنید. پس از آن، می توانید برای ایجاد ویرایشگر صفحه گسترده آنلاین خود پیش بروید.
برای جزئیات بیشتر، گزینهها و مثالها، میتوانید از documentation و مخزن GitHub دیدن کنید. . برای سؤالات بیشتر، با پشتیبانی در فروم تماس بگیرید.