GetDocumentInfo
Editor.GetDocumentInfo method
إرجاع البيانات الوصفية الخاصة بالمستند الذي تم تحميله إلى مثيل “المحرر” هذا
public IDocumentInfo GetDocumentInfo(string password)
معامل | يكتب | وصف |
---|---|---|
password | String | يمكن للمستخدم تحديد كلمة مرور للمستند ، إذا تم تشفير هذا المستند بكلمة المرور . قد يكون سلسلة فارغة أو فارغة ، وهذا يعادل كلمة المرور الغائبة. بالنسبة إلى تنسيقات المستندات ، التي لا تحتوي على ميزة حماية كلمة المرور ، سيتم تجاهل هذه الوسيطة. إذا كان المستند مشفرًا ، وكلمة المرور غير محددة في هذه المعلمة ، ولكن تم تحديدها من قبل في خيارات التحميل أثناء إنشاء هذاEditor على سبيل المثال ، سيتم استخدامه. |
قيمة الإرجاع
الوراثة الخاصة بالتنسيقIDocumentInfo
واجهة ، تشير إلى التنسيق المكتشف مع البيانات الوصفية الخاصة بالتنسيق ، أو NULL ، إذا لم يتم التعرف على المستند على أنه قابل للدعم أو تالف.
استثناءات
استثناء | حالة |
---|---|
ObjectDisposedException | تم طرحه عندما تم بالفعل التخلص من مثيل المحرر عند استدعاء “GetDocumentInfo” |
PasswordRequiredException | يتم طرحه عندما يكون المستند الذي تم تحميله محميًا بكلمة مرور ، ولكن لم يتم تحديد كلمة المرور في المعلمة “password” |
IncorrectPasswordException | يتم طرحه عندما يكون المستند الذي تم تحميله محميًا بكلمة مرور ، ويتم تحديد كلمة المرور ، ولكنها غير صحيحة |
InvalidOperationException | يتم طرحها عند حدوث خطأ غير متوقع ذي طبيعة غير معروفة |
ملاحظات
تكون طريقة GetDocumentInfo مفيدة عندما لا يكون من الواضح أي تنسيق هو مستند الإدخال ، هل هو محمي بكلمة مرور و / أو عدد الصفحات / أوراق العمل / الشرائح التي يحتوي عليها. استنادًا إلى بيانات التعريف هذه ، التي تم إرجاعها بواسطة GetDocumentInfo ، من الممكن ضبط خيارات التحميل والتحرير بشكل صحيح لخط أنابيب المعالجة الرئيسي.
تقوم طريقة GetDocumentInfo دائمًا بإرجاع البيانات الكاملة ، ولا تتأثر بالوضع التجريبي ، ولا يؤدي استخدامها إلى حذف وحدات البايت أو الاعتمادات المستهلكة.
يتعلم أكثر
- تعرف على المزيد حول الحصول على خصائص محددة للمستند في الكود: كيفية الحصول على معلومات المستند باستخدام GroupDocs.Editor
أنظر أيضا
- interface IDocumentInfo
- class Editor
- مساحة الاسم GroupDocs.Editor
- المجسم GroupDocs.Editor