Workbook صف

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

يكشف النوع Workbook عن الأعضاء التاليين:

البنائين

البناء	وصف
`__init__(self)`	يقوم بتهيئة مثيل جديد للفئة `Workbook`.
`__init__(self, file_format_type)`	يقوم بتهيئة مثيل جديد للفئة `Workbook`.
`__init__(self, file)`	يقوم بتهيئة مثيل جديد لفئة `Workbook` وفتح ملف.
`__init__(self, stream)`	يقوم بتهيئة مثيل جديد للفئة `Workbook` وفتح مجرى.
`__init__(self, file, load_options)`	يقوم بتهيئة مثيل جديد لفئة `Workbook` وفتح ملف.
`__init__(self, stream, load_options)`	يقوم بتهيئة مثيل جديد لفئة `Workbook` ويفتح مجرى مفتوح.

ملكيات

ملكية	وصف
settings	يمثل إعدادات المصنف.
worksheets	يحصل على المجموعة `WorksheetCollection` في جدول البيانات.
is_licensed	يشير إلى ما إذا كان الترخيص قد تم تعيينه.
colors	إرجاع الألوان الموجودة في لوحة الألوان الخاصة بجدول البيانات.
count_of_styles_in_pool	يحصل على عدد الأنماط الموجودة في مجموعة الأنماط.
default_style	يحصل على أو يعين الكائن الافتراضي `Style` للمصنف.
is_digitally_signed	يشير إلى ما إذا كانت هذه الجداول موقعة رقميًا.
is_workbook_protected_with_password	يشير إلى ما إذا كان الهيكل أو النافذة محمية بكلمة مرور.
vba_project	يحصل على `Workbook.vba_project` في جدول بيانات.
has_macro	يشير إلى ما إذا كانت هذه جدول البيانات تحتوي على ماكرو/VBA.
has_revisions	يحصل على ما إذا كان المصنف يحتوي على أي تغييرات متعقبة
file_name	يحصل على اسم الملف الحالي ويقوم بتعيينه.
cells_data_table_factory	يحصل على المصنع لبناء ICellsDataTable من الكائنات المخصصة
data_sorter	يحصل على كائن DataSorter لفرز البيانات.
theme	يحصل على اسم الموضوع.
built_in_document_properties	إرجاع مجموعة `DocumentProperty` التي تمثل كافة خصائص المستند المضمنة في جدول البيانات.
custom_document_properties	إرجاع مجموعة `DocumentProperty` التي تمثل كافة خصائص المستند المخصصة لجدول البيانات.
file_format	يحصل على تنسيق الملف ويحدده.
has_custom_function	يكتشف ما إذا كانت هناك وظيفة مخصصة مستخدمة في هذا المصنف، كما هو الحال في صيغة الخلية، وفي الأسماء المحددة…
content_type_properties	يحصل على قائمة `ContentTypeProperty` من الكائنات الموجودة في المصنف.
custom_xml_parts	يمثل جزء تخزين بيانات XML مخصص (بيانات XML مخصصة ضمن حزمة).
data_mashup	يحصل على بيانات المزيج.
ribbon_xml	يحصل على ملف XML الذي يحدد واجهة المستخدم الشريطية ويقوم بتعيينه.
absolute_path	يحصل على المسار المطلق للملف ويحدده.
data_connections	يحصل على مجموعة ExternalConnection.
data_model	يحصل على نموذج البيانات في المصنف.

طُرق

طريقة	وصف
`save(self, file_name, save_format)`	يحفظ المصنف على القرص.
`save(self, file_name)`	احفظ المصنف على القرص.
`save(self, file_name, save_options)`	يحفظ المصنف على القرص.
`save(self, stream, save_format)`	يحفظ المصنف في الدفق.
`save(self, stream, save_options)`	يحفظ المصنف في الدفق.
`create_style(self)`	إنشاء نمط جديد.
`create_style(self, clone_default_style)`	إنشاء نمط جديد.
`replace(self, place_holder, new_value)`	استبدال قيمة الخلية بسلسلة جديدة.
`replace(self, place_holder, new_value)`	استبدال قيمة الخلية برقم صحيح جديد.
`replace(self, place_holder, new_value)`	استبدال قيمة الخلية بقيمة مزدوجة جديدة.
`replace(self, place_holder, new_values, is_vertical)`	استبدال قيمة الخلية بمصفوفة سلسلة جديدة.
`replace(self, place_holder, new_values, is_vertical)`	استبدال قيم الخلايا بمصفوفة عددية صحيحة.
`replace(self, place_holder, new_values, is_vertical)`	استبدال قيم الخلايا بمصفوفة مزدوجة.
`replace(self, bool_value, new_value)`	استبدال قيم الخلايا ببيانات جديدة.
`replace(self, int_value, new_value)`	استبدال قيم الخلايا ببيانات جديدة.
`replace(self, place_holder, new_value, options)`	استبدال قيمة الخلية بسلسلة جديدة.
`copy(self, source, copy_options)`	نسخ كائن آخر من مصنف.
`copy(self, source)`	نسخ البيانات من كائن مصنف المصدر.
`calculate_formula(self)`	يحسب نتيجة الصيغ.
`calculate_formula(self, ignore_error)`	يحسب نتيجة الصيغ.
`calculate_formula(self, options)`	حساب الصيغ في هذا المصنف.
`refresh_dynamic_array_formulas(self, calculate)`	تحديث صيغ المصفوفة الديناميكية (الانسكاب في نطاق جديد من الخلايا المجاورة وفقًا للبيانات الحالية) لن يتم حساب الصيغ الأخرى الموجودة في المصنف بشكل متكرر حتى لو تم استخدامها بواسطة صيغ المصفوفة الديناميكية.
`refresh_dynamic_array_formulas(self, calculate, copts)`	تحديث صيغ المصفوفة الديناميكية (الانسكاب في نطاق جديد من الخلايا المجاورة وفقًا للبيانات الحالية)
`import_xml(self, url, sheet_name, row, col)`	استيراد/تحديث ملف بيانات XML إلى المصنف.
`import_xml(self, stream, sheet_name, row, col)`	استيراد/تحديث ملف بيانات XML إلى المصنف.
`export_xml(self, map_name, path)`	تصدير بيانات XML المرتبطة بخريطة XML المحددة.
`export_xml(self, map_name, stream)`	تصدير بيانات XML.
`parse_formulas(self, ignore_error)`	يقوم بتحليل جميع الصيغ التي لم يتم تحليلها عند تحميلها من ملف قالب أو تعيينها إلى خلية.
`start_access_cache(self, opts)`	بدء الجلسة التي تستخدم ذاكرة التخزين المؤقت للوصول إلى البيانات.
`close_access_cache(self, opts)`	إغلاق الجلسة التي تستخدم ذاكرة التخزين المؤقت للوصول إلى البيانات.
`remove_unused_styles(self)`	إزالة كافة الأنماط غير المستخدمة.
`create_builtin_style(self, type)`	إنشاء نمط مدمج حسب النوع المحدد.
`create_cells_color(self)`	إنشاء الكائن `CellsColor`.
`combine(self, second_workbook)`	دمج كائن مصنف آخر.
`get_style_in_pool(self, index)`	يحصل على الأسلوب في مجموعة الأسلوب. سيتم تجميع كافة الأنماط الموجودة في مصنف العمل في مجموعة واحدة. لا يوجد سوى فهرس مرجعي بسيط في الخلايا.
`get_fonts(self)`	يحصل على كافة الخطوط الموجودة في مجموعة الأنماط.
`get_named_style(self, name)`	يحصل على النمط المحدد في مجموعة الأنماط.
`merge_named_styles(self, source)`	دمج الأنماط المسماة من ملف Excel الآخر.
`change_palette(self, color, index)`	تغيير لوحة الألوان للجدول الإلكتروني في الفهرس المحدد.
`is_color_in_palette(self, color)`	التحقق مما إذا كان اللون موجودًا في لوحة الألوان الخاصة بجدول البيانات.
`get_matching_color(self, raw_color)`	ابحث عن أفضل لون مطابق في اللوحة الحالية.
`set_encryption_options(self, encryption_type, key_length)`	تعيين خيارات التشفير.
`protect(self, protection_type, password)`	يحمي المصنف.
`protect_shared_workbook(self, password)`	يحمي المصنف المشترك.
`unprotect(self, password)`	إلغاء حماية المصنف.
`unprotect_shared_workbook(self, password)`	إلغاء حماية مصنف مشترك.
`remove_macro(self)`	إزالة VBA/الماكرو من جدول البيانات هذا.
`remove_digital_signature(self)`	إزالة التوقيع الرقمي من جدول البيانات هذا.
`accept_all_revisions(self)`	يقبل كافة التغييرات المتعقبة في المصنف.
`remove_external_links(self)`	يزيل كافة الروابط الخارجية الموجودة في المصنف.
`get_theme_color(self, type)`	يحصل على لون الموضوع.
`set_theme_color(self, type, color)`	تعيين لون السمة
`custom_theme(self, theme_name, colors)`	الجمارك هي الموضوع.
`copy_theme(self, source)`	نسخ الموضوع من مصنف آخر.
`has_exernal_links(self)`	يشير إلى ما إذا كان هذا المصنف يحتوي على روابط خارجية لمصادر بيانات أخرى.
`update_custom_function_definition(self, definition)`	تحديث تعريف الوظائف المخصصة.
`update_linked_data_source(self, external_workbooks)`	إذا كان هذا المصنف يحتوي على روابط خارجية لمصدر بيانات آخر، سيحاول Aspose.Cells استرداد أحدث البيانات من المصادر المحددة.
`set_digital_signature(self, digital_signature_collection)`	تعيين التوقيع الرقمي لملف جدول بيانات (Excel2007 والإصدارات الأحدث).
`add_digital_signature(self, digital_signature_collection)`	يضيف التوقيع الرقمي إلى ملف جدول بيانات OOXML (Excel2007 والإصدارات الأحدث).
`get_digital_signature(self)`	يحصل على التوقيع الرقمي من الملف.
`remove_personal_information(self)`	إزالة المعلومات الشخصية.
`close(self)`	يتم تخطي Dispose() بواسطة الغلاف منذ البروتوكول Python

ملاحظات

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

مثال

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

from aspose.cells import Workbook

# Open a designer file
designerFile = "designer.xls"
workbook = Workbook(designerFile)
# Set scroll bars
workbook.settings.is_h_scroll_bar_visible = False
workbook.settings.is_v_scroll_bar_visible = False
# Replace the placeholder string with new values
newInt = 100
workbook.replace("OldInt", newInt)
newString = "Hello!"
workbook.replace("OldString", newString)
workbook.save("result.xlsx")

أنظر أيضا

WarningInfo صف WorkbookDesigner صف