GetDocumentInfo

Editor.GetDocumentInfo method

إرجاع البيانات الوصفية الخاصة بالمستند الذي تم تحميله إلى مثيل “المحرر” هذا

public IDocumentInfo GetDocumentInfo(string password)
معامل يكتب وصف
password String يمكن للمستخدم تحديد كلمة مرور للمستند ، إذا تم تشفير هذا المستند بكلمة المرور . قد يكون سلسلة فارغة أو فارغة ، وهذا يعادل كلمة المرور الغائبة. بالنسبة إلى تنسيقات المستندات ، التي لا تحتوي على ميزة حماية كلمة المرور ، سيتم تجاهل هذه الوسيطة. إذا كان المستند مشفرًا ، وكلمة المرور غير محددة في هذه المعلمة ، ولكن تم تحديدها من قبل في خيارات التحميل أثناء إنشاء هذاEditor على سبيل المثال ، سيتم استخدامه.

قيمة الإرجاع

الوراثة الخاصة بالتنسيقIDocumentInfo واجهة ، تشير إلى التنسيق المكتشف مع البيانات الوصفية الخاصة بالتنسيق ، أو NULL ، إذا لم يتم التعرف على المستند على أنه قابل للدعم أو تالف.

استثناءات

استثناء حالة
ObjectDisposedException تم طرحه عندما تم بالفعل التخلص من مثيل المحرر عند استدعاء “GetDocumentInfo”
PasswordRequiredException يتم طرحه عندما يكون المستند الذي تم تحميله محميًا بكلمة مرور ، ولكن لم يتم تحديد كلمة المرور في المعلمة “password”
IncorrectPasswordException يتم طرحه عندما يكون المستند الذي تم تحميله محميًا بكلمة مرور ، ويتم تحديد كلمة المرور ، ولكنها غير صحيحة
InvalidOperationException يتم طرحها عند حدوث خطأ غير متوقع ذي طبيعة غير معروفة

ملاحظات

تكون طريقة GetDocumentInfo مفيدة عندما لا يكون من الواضح أي تنسيق هو مستند الإدخال ، هل هو محمي بكلمة مرور و / أو عدد الصفحات / أوراق العمل / الشرائح التي يحتوي عليها. استنادًا إلى بيانات التعريف هذه ، التي تم إرجاعها بواسطة GetDocumentInfo ، من الممكن ضبط خيارات التحميل والتحرير بشكل صحيح لخط أنابيب المعالجة الرئيسي.

تقوم طريقة GetDocumentInfo دائمًا بإرجاع البيانات الكاملة ، ولا تتأثر بالوضع التجريبي ، ولا يؤدي استخدامها إلى حذف وحدات البايت أو الاعتمادات المستهلكة.

يتعلم أكثر

أنظر أيضا

Edit Save