کار با ویژگی های سند

ویژگی های سند اجازه ذخیره اطلاعات مفید در مورد سند شما را می دهد. این خواص را می توان به دو گروه تقسیم کرد:

  • سیستم یا داخلی که شامل مقادیر مانند عنوان سند، نام نویسنده، آمار سند و دیگران است.
  • تعریف شده توسط کاربر یا سفارشی، به عنوان جفت نام و ارزش ارائه شده است که در آن کاربر می تواند نام و ارزش را تعریف کند.

مفید است بدانید که اطلاعات مربوط به API و شماره نسخه به طور مستقیم به اسناد خروجی نوشته شده است. به عنوان مثال، پس از تبدیل یک سند به PDF، Aspose.Words فیلد “Application” را با “Aspose.Words “و فیلد” PDF Producer “را با"Aspose.Words برای C++ YY.M. N “، که در آن YY.M.N نسخه Aspose.Words برای تبدیل استفاده می شود. برای جزئیات بیشتر، به نام ژنراتور یا تولید کننده در اسناد خروجی گنجانده شده است.

ویژگی های سند دسترسی

برای دسترسی به ویژگی های سند در Aspose.Words استفاده کنید:

BuiltInDocumentProperties

BuiltInDocumentProperties

کلاس DocumentProperty به شما اجازه می دهد تا نام، ارزش و نوع یک ویژگی سند را بدست آورید. Value یک شی را باز می گرداند، اما مجموعه ای از روش ها وجود دارد که به شما اجازه می دهد ارزش خاصیت را به یک نوع خاص تبدیل کنید. پس از اینکه با نوع خاصیت آشنا شدید، می توانید از یکی از روش های DocumentProperty.ToXXX مانند DocumentProperty.ToString و DocumentProperty.ToInt برای بدست آوردن مقدار نوع مناسب استفاده کنید.

مثال کد زیر نشان می دهد که چگونه تمام ویژگی های داخلی و سفارشی را در یک سند فهرست کنیم:

در Microsoft Word، می توانید با استفاده از منوی “File → Properties” به ویژگی های سند دسترسی پیدا کنید.

work-with-document-properties-aspose-words-cpp_1.png

اضافه کردن یا حذف ویژگی های سند

شما نمی توانید ویژگی های سند داخلی را با استفاده از Aspose.Words اضافه یا حذف کنید. شما فقط می توانید ارزش های خود را تغییر دهید یا به روز کنید.

برای اضافه کردن ویژگی های سند سفارشی با Aspose.Words، از روش Add استفاده کنید، نام خاصیت جدید و ارزش نوع مناسب را منتقل کنید. روش شیء DocumentProperty تازه ایجاد شده را باز می گرداند.

برای حذف ویژگی های سفارشی، از روش Remove استفاده کنید، نام ویژگی را برای حذف به آن منتقل کنید، یا روش RemoveAt برای حذف ویژگی با شاخص. شما همچنین می توانید تمام ویژگی ها را با استفاده از روش Clear حذف کنید.

مثال کد زیر بررسی می کند که آیا یک ویژگی سفارشی با نام داده شده در یک سند وجود دارد و چند ویژگی سند سفارشی دیگر را اضافه می کند:

مثال کد زیر نشان می دهد که چگونه یک ویژگی سند سفارشی را حذف کنیم:

ویژگی های سند داخلی را به روز کنید

Aspose.Words به طور خودکار ویژگی های سند را به روز نمی کند، همانطور که Microsoft Word با برخی از ویژگی ها انجام می دهد، اما روشی را برای به روز رسانی برخی از ویژگی های سند داخلی آماری فراهم می کند. برای محاسبه مجدد و به روز رسانی ویژگی های زیر، روش UpdateWordCount را فراخوانی کنید:

ایجاد یک ویژگی سفارشی جدید مرتبط با محتوا

Aspose.Words روش AddLinkToContent را برای ایجاد یک ویژگی سند سفارشی جدید مرتبط با محتوا فراهم می کند. این خاصیت اگر LinkSource نامعتبر باشد، شیء خاصیت جدید ایجاد شده یا null را باز می گرداند.

مثال کد زیر نشان می دهد که چگونه یک لینک به یک ویژگی سفارشی را پیکربندی کنید:

متغیرهای سند را دریافت کنید

شما می توانید مجموعه ای از متغیرهای سند را با استفاده از ویژگی Variables دریافت کنید. نام ها و مقادیر متغیر رشته ها هستند.

مثال کد زیر نشان می دهد که چگونه متغیرهای سند را شمارش کنیم:

حذف اطلاعات شخصی از سند

اگر می خواهید یک سند Word را با افراد دیگر به اشتراک بگذارید، ممکن است بخواهید اطلاعات شخصی مانند نام نویسنده و شرکت را حذف کنید. برای انجام این کار از ویژگی RemovePersonalInformation برای تنظیم پرچم استفاده کنید که نشان می دهد Microsoft Word تمام اطلاعات کاربر را از نظرات، بازبینی ها و ویژگی های سند پس از ذخیره سند حذف می کند.

مثال کد زیر نشان می دهد که چگونه اطلاعات شخصی را حذف کنیم:

تبدیل بین واحدهای اندازه گیری در C++