کار با Document Properties
ویژگی های سند اجازه می دهد تا برخی از اطلاعات مفید در مورد سند شما ذخیره شود. این خواص را می توان به دو گروه تقسیم کرد:
- سیستم یا داخلی که حاوی مقادیری مانند عنوان سند، نام نویسنده، آمار سند و موارد دیگر است.
- تعریف شده توسط کاربر یا سفارشی، ارائه شده به عنوان جفت نام-مقدار که در آن کاربر می تواند نام و مقدار را تعریف کند.
دانستن این نکته مفید است که اطلاعات مربوط به API و شماره نسخه مستقیماً در اسناد خروجی نوشته می شود. به عنوان مثال، پس از تبدیل یک سند به PDF، Aspose.Words فیلد “برنامه” را با “Aspose.Words” و قسمت “PDF Producer” را با “Aspose.Words for .NET YY.MN” پر می کند، جایی که YY.M.N نسخه Aspose.Words است که برای تبدیل استفاده می شود.. برای جزئیات بیشتر، نام تولید کننده یا تولید کننده در اسناد خروجی درج شده است را ببینید.
دسترسی به ویژگی های سند
برای دسترسی به ویژگی های سند در Aspose.Words از:
-
built_in_document_properties برای به دست آوردن ویژگی های داخلی.
-
custom_document_properties برای به دست آوردن خواص سفارشی.
built_in_document_properties و custom_document_properties مجموعه ای از اشیاء DocumentProperty هستند. این اشیاء را می توان از طریق ویژگی ایندکس کننده با نام یا با فهرست به دست آورد.
built_in_document_properties علاوه بر این دسترسی به ویژگی های سند را از طریق مجموعه ای از ویژگی های وارد شده فراهم می کند که مقادیری از نوع مناسب را برمی گرداند. custom_document_properties شما را قادر می سازد تا ویژگی های سند را از یک سند اضافه یا حذف کنید.
کلاس DocumentProperty به شما امکان می دهد نام، مقدار و نوع یک ویژگی سند را بدست آورید. value یک شی را برمی گرداند، اما مجموعه ای از روش ها وجود دارد که به شما امکان می دهد مقدار ویژگی را به یک نوع خاص تبدیل کنید. بعد از اینکه متوجه شدید که نوع خاصیت چیست، می توانید از یکی از روش های DocumentProperty.to_XXX مانند DocumentProperty.__str__ و DocumentProperty.to_int برای بدست آوردن مقدار نوع مناسب استفاده کنید.
مثال کد زیر نحوه برشمردن تمام خصوصیات داخلی و سفارشی را در یک سند نشان می دهد:
در Microsoft Word، می توانید با استفاده از منوی “File → Properties” به ویژگی های سند دسترسی پیدا کنید.
افزودن یا حذف ویژگی های سند
شما نمی توانید ویژگی های سند داخلی را با استفاده از Aspose.Words اضافه یا حذف کنید. شما فقط می توانید مقادیر آنها را تغییر دهید یا به روز کنید.
برای افزودن ویژگی های سند سفارشی با Aspose.Words، از روش add استفاده کنید، نام ویژگی جدید و مقدار نوع مناسب را ارسال کنید. متد شی DocumentProperty تازه ایجاد شده را برمی گرداند.
برای حذف ویژگی های سفارشی، از روش remove استفاده کنید، نام ویژگی را برای حذف به آن ارسال کنید، یا از روش remove_at برای حذف ویژگی با فهرست استفاده کنید. شما همچنین می توانید با استفاده از روش clear تمام ویژگی ها را حذف کنید.
مثال کد زیر بررسی می کند که آیا یک ویژگی سفارشی با یک نام مشخص در یک سند وجود دارد یا خیر و چند ویژگی سند سفارشی دیگر اضافه می کند:
مثال کد زیر نحوه حذف ویژگی سند سفارشی را نشان می دهد:
ویژگی های سند داخلی را به روز کنید
Aspose.Words به‌طور خودکار ویژگی‌های سند را به‌روزرسانی نمی‌کند، همانطور که Microsoft Word با برخی از ویژگی‌ها انجام می‌دهد، اما روشی برای به‌روزرسانی برخی ویژگی‌های آماری داخلی ارائه می‌دهد. برای محاسبه مجدد و به روز رسانی ویژگی های زیر، متد update_word_count را فراخوانی کنید:
یک ویژگی سفارشی جدید مرتبط با محتوا ایجاد کنید
Aspose.Words روش add_link_to_content را برای ایجاد یک ویژگی سند سفارشی جدید مرتبط با محتوا فراهم می کند. اگر لینک_منبع نامعتبر باشد، این ویژگی شیء ویژگی جدید ایجاد شده یا null را برمی گرداند.
مثال کد زیر نحوه پیکربندی پیوند به یک ویژگی سفارشی را نشان می دهد:
دریافت متغیرهای سند
شما می توانید مجموعه ای از متغیرهای سند را با استفاده از ویژگی variables دریافت کنید. نام و مقادیر متغیرها رشته هستند.
مثال کد زیر نحوه افزودن و دسترسی به متغیرهای سند را نشان می دهد:
اطلاعات شخصی را از سند حذف کنید
اگر می خواهید یک سند Word را با افراد دیگر به اشتراک بگذارید، ممکن است بخواهید اطلاعات شخصی مانند نام نویسنده و شرکت را حذف کنید. برای انجام این کار از ویژگی remove_personal_information برای تنظیم پرچم استفاده کنید که نشان می دهد Microsoft Word پس از ذخیره سند، تمام اطلاعات کاربر را از نظرات، ویرایش ها و ویژگی های سند حذف می کند.
مثال کد زیر نحوه حذف اطلاعات شخصی را نشان می دهد: