Workbook

Workbook class

يمثل كائنًا جذرًا لإنشاء جدول بيانات Excel.

public class Workbook : IDisposable

المنشئون

اسموصف
Workbook()يقوم بتهيئة مثيل جديد لملفWorkbook فئة .
Workbook(FileFormatType)يقوم بتهيئة مثيل جديد لملفWorkbook فئة .
Workbook(Stream)يقوم بتهيئة مثيل جديد لملفWorkbook فئة وافتح دفق.
Workbook(string)يقوم بتهيئة مثيل جديد لملفWorkbook فئة وافتح ملفًا.
Workbook(Stream, LoadOptions)يقوم بتهيئة مثيل جديد لملفWorkbook فئة ودفق مفتوح.
Workbook(string, LoadOptions)يقوم بتهيئة مثيل جديد لملفWorkbook فئة وافتح ملفًا.

الخصائص

اسموصف
AbsolutePath { get; set; }الحصول على المسار المطلق للملف وتعيينه.
BuiltInDocumentProperties { get; }إرجاع أDocumentPropertyمجموعة تمثل جميع خصائص المستند المضمنة في جدول البيانات.
CellsDataTableFactory { get; }الحصول على المصنع لبناء ICellsDataTable من كائنات مخصصة
Colors { get; }إرجاع الألوان في اللوحة لجدول البيانات.
ContentTypeProperties { get; }يحصل على قائمةContentTypeProperty كائنات في المصنف.
CountOfStylesInPool { get; }الحصول على عدد الأنماط في تجمع الأنماط .
CustomDocumentProperties { get; }إرجاع أDocumentProperty المجموعة التي تمثل جميع خصائص المستند المخصصة لجدول البيانات.
CustomXmlParts { get; }يمثل جزء تخزين بيانات XML مخصص (بيانات XML مخصصة داخل حزمة).
DataConnections { get; }يحصل على ملفExternalConnection جمع .
DataMashup { get; }الحصول على بيانات Mashup .
DataSorter { get; }يحصل على كائن DataSorter لفرز البيانات.
DefaultStyle { get; set; }الحصول على الإعداد الافتراضي أو تعيينهStyle كائن من المصنف .
FileFormat { get; set; }الحصول على تنسيق الملف وتعيينه.
FileName { get; set; }الحصول على اسم الملف الحالي وتعيينه.
HasMacro { get; }يشير إلى ما إذا كان جدول البيانات هذا يحتوي على ماكرو / VBA.
HasRevisions { get; }يتم الحصول على ما إذا كان المصنف يحتوي على أي تغييرات متعقبة
InterruptMonitor { get; set; }الحصول على شاشة المقاطعة وتعيينها.
IsDigitallySigned { get; }يشير إلى ما إذا كان جدول البيانات هذا موقعًا رقميًا.
IsLicensed { get; }يشير إلى ما إذا تم تعيين الترخيص .
IsWorkbookProtectedWithPassword { get; }يشير إلى ما إذا كانت البنية أو النافذة محمية بكلمة مرور.
RibbonXml { get; set; }الحصول على ملف XML الذي يحدد واجهة مستخدم الشريط وتعيينه.
Settings { get; }يمثل إعدادات المصنف.
Theme { get; }يحصل على اسم المظهر.
VbaProject { get; }يحصل على ملفVbaProject في جدول بيانات .
Worksheets { get; }يحصل على ملفWorksheetCollection جمع في جدول البيانات.

طُرق

اسموصف
AcceptAllRevisions()يقبل كافة التغييرات المتعقبة في المصنف.
AddDigitalSignature(DigitalSignatureCollection)إضافة توقيع رقمي إلى ملف جدول بيانات OOXML (Excel2007 والإصدارات الأحدث).
CalculateFormula()حساب نتيجة الصيغ .
CalculateFormula(bool)حساب نتيجة الصيغ .
CalculateFormula(CalculationOptions)حساب الصيغ في هذا المصنف.
ChangePalette(Color, int)يغير لوحة جدول البيانات في الفهرس المحدد.
CloseAccessCache(AccessCacheOptions)إغلاق الجلسة التي تستخدم ذاكرات التخزين المؤقت للوصول إلى البيانات.
Combine(Workbook)يجمع بين كائن مصنف آخر.
Copy(Workbook)نسخ البيانات من كائن مصنف مصدر .
Copy(Workbook, CopyOptions)نسخ البيانات من كائن مصنف مصدر .
CopyTheme(Workbook)نسخ النسق من مصنف آخر .
CreateBuiltinStyle(BuiltinStyleType)ينشئ نمطًا مدمجًا حسب النوع المحدد.
CreateCellsColor()ينشئ ملفCellsColor الكائن .
CreateStyle()ينشئ نمطًا جديدًا .
CustomTheme(string, Color[])جمارك الموضوع .
Dispose()يؤدي مهام محددة بواسطة التطبيق مرتبطة بتحرير الموارد غير المُدارة أو تحريرها أو إعادة تعيينها.
ExportXml(string, Stream)تصدير بيانات XML .
ExportXml(string, string)تصدير بيانات XML المرتبطة بخريطة XML المحددة.
GetDigitalSignature()الحصول على توقيع رقمي من ملف .
GetFonts()يحصل على كل الخطوط في تجمع الأنماط .
GetMatchingColor(Color)البحث عن أفضل الألوان المطابقة في لوحة الألوان الحالية.
GetNamedStyle(string)الحصول على النمط المسمى في تجمع الأنماط .
GetStyleInPool(int)الحصول على النمط في تجمع الأنماط. سيتم تجميع كافة الأنماط الموجودة في المصنف في مجموعة . لا يوجد سوى فهرس مرجعي بسيط في الخلايا .
GetThemeColor(ThemeColorType)الحصول على لون المظهر.
ImportXml(Stream, string, int, int)يستورد / يحدّث ملف بيانات XML في المصنف.
ImportXml(string, string, int, int)يستورد / يحدّث ملف بيانات XML في المصنف.
IsColorInPalette(Color)للتحقق مما إذا كان اللون موجودًا في لوحة جدول البيانات.
ParseFormulas(bool)يوزع جميع الصيغ التي لم يتم تحليلها عند تحميلها من ملف قالب أو تعيينها إلى خلية.
Protect(ProtectionType, string)حماية مصنف.
ProtectSharedWorkbook(string)حماية مصنف مشترك .
RefreshDynamicArrayFormulas(bool)تحديث صيغ الصفيف الديناميكية (الانسكاب في نطاق جديد من الخلايا المجاورة وفقًا للبيانات الحالية)
RemoveDigitalSignature()يزيل التوقيع الرقمي من جدول البيانات هذا.
RemoveMacro()يزيل VBA / الماكرو من جدول البيانات هذا.
RemovePersonalInformation()إزالة المعلومات الشخصية .
RemoveUnusedStyles()قم بإزالة كافة الأنماط غير المستخدمة.
Replace(bool, object)يستبدل قيم الخلايا ببيانات جديدة.
Replace(int, object)يستبدل قيم الخلايا ببيانات جديدة.
Replace(string, DataTable)يستبدل قيم الخلايا ببيانات من ملفDataTable .
Replace(string, double)يستبدل قيمة الخلية بمزدوج جديد.
Replace(string, int)يستبدل قيمة الخلية بعدد صحيح جديد.
Replace(string, string)يستبدل قيمة الخلية بسلسلة جديدة.
Replace(string, double[], bool)يستبدل قيم الخلايا بمصفوفة مزدوجة.
Replace(string, int[], bool)يستبدل قيم الخلايا بمصفوفة عدد صحيح.
Replace(string, string, ReplaceOptions)يستبدل قيمة الخلية بسلسلة جديدة.
Replace(string, string[], bool)يستبدل قيمة الخلية بمصفوفة سلسلة جديدة.
Save(string)احفظ المصنف على القرص.
Save(Stream, SaveFormat)يحفظ المصنف في الدفق .
Save(Stream, SaveOptions)يحفظ المصنف في الدفق .
Save(string, SaveFormat)يحفظ المصنف على القرص .
Save(string, SaveOptions)يحفظ المصنف على القرص .
Save(HttpResponse, string, ContentDisposition, SaveOptions)يقوم بإنشاء جدول البيانات الناتج ونقله إلى العميل ثم فتحه في المتصفح أو MS Workbook .
Save(HttpResponse, string, ContentDisposition, SaveOptions, bool)يقوم بإنشاء جدول البيانات الناتج ونقله إلى العميل ثم فتحه في المتصفح أو MS Workbook .
SaveToStream()يحفظ ملف Excel في كائن MemoryStream وإعادته.
SetDigitalSignature(DigitalSignatureCollection)تعيين التوقيع الرقمي إلى ملف جدول بيانات (Excel2007 والإصدارات الأحدث).
SetEncryptionOptions(EncryptionType, int)تعيين خيارات التشفير .
SetThemeColor(ThemeColorType, Color)يحدد لون السمة
StartAccessCache(AccessCacheOptions)يبدأ الجلسة التي تستخدم ذاكرات التخزين المؤقت للوصول إلى البيانات.
Unprotect(string)إلغاء حماية مصنف .
UnprotectSharedWorkbook(string)إلغاء حماية مصنف مشترك.
UpdateLinkedDataSource(Workbook[])إذا كان هذا المصنف يحتوي على ارتباطات خارجية بمصدر بيانات آخر ، فسيحاول Aspose.Cells استرداد أحدث البيانات.

ملاحظات

تشير فئة المصنف إلى جدول بيانات Excel. يمكن أن يحتوي كل جدول بيانات على أوراق عمل متعددة. الميزة الأساسية للفصل هي فتح ملفات Excel الأصلية وحفظها. يحتوي الفصل على بعض الميزات المتقدمة مثل نسخ البيانات من مصنفات أخرى ، والجمع بين مصنفين وحماية جدول بيانات Excel .

أمثلة

يقوم المثال التالي بتحميل مصنف من ملف باسم designer.xls ويجعل أشرطة التمرير الأفقية والعمودية غير مرئية للمصنف. ثم يستبدل قيمتي سلسلة بقيمة عدد صحيح وقيمة سلسلة على التوالي داخل جدول البيانات وأخيرًا يرسل الملف المحدث إلى متصفح العميل.

[C#]

// فتح ملف المصمم
string designerFile = "designer.xls";
Workbook workbook = new Workbook(designerFile);

// تعيين أشرطة التمرير
workbook.Settings.IsHScrollBarVisible = false;
workbook.Settings.IsVScrollBarVisible = false;

// استبدل سلسلة العنصر النائب بقيم جديدة
int newInt = 100;
workbook.Replace("OldInt", newInt);

string newString = "Hello!";
workbook.Replace("OldString", newString);
workbook.Save("result.xls");

[Visual Basic]

'افتح ملف المصمم
Dim designerFile as String = "\designer.xls"
Dim workbook as Workbook = new Workbook(designerFile)

'تعيين أشرطة التمرير
workbook.IsHScrollBarVisible = False
workbook.IsVScrollBarVisible = False

'استبدل سلسلة العنصر النائب بقيم جديدة
Dim newInt as Integer = 100
workbook.Replace("OldInt", newInt)

Dim newString as String = "Hello!"
workbook.Replace("OldString", newString)
workbook.Save("result.xls")    

أنظر أيضا