FileFormatInfo

FileFormatInfo class

يحتوي على البيانات التي تم إرجاعها بواسطةFileFormatUtil طرق الكشف عن تنسيق المستند.

لمعرفة المزيد، قم بزيارةكشف تنسيق الملف والتحقق من توافق التنسيق مقالة توثيقية.

public class FileFormatInfo

الخصائص

اسموصف
Encoding { get; }يحصل على الترميز المكتشف إذا كان قابلاً للتطبيق على تنسيق المستند الحالي. في الوقت الحالي يكتشف الترميز فقط لمستندات HTML.
HasDigitalSignature { get; }إرجاعحقيقيإذا كان هذا المستند يحتوي على توقيع رقمي. تشير هذه الخاصية فقط إلى وجود توقيع رقمي في المستند، ولكنها لا تحدد ما إذا كان التوقيع صالحًا أم لا.
IsEncrypted { get; }إرجاعحقيقي إذا كان المستند مشفرًا ويتطلب كلمة مرور لفتحه.
LoadFormat { get; }الحصول على تنسيق المستند الذي تم اكتشافه.

ملاحظات

لا تقم بإنشاء مثيلات هذه الفئة مباشرة. يتم إرجاع كائنات هذه الفئة بواسطة DetectFileFormat طُرق.

أمثلة

يوضح كيفية استخدام فئة FileFormatUtil للكشف عن تنسيق المستند وتشفيره.

Document doc = new Document();

// قم بتكوين كائن SaveOptions لتشفير المستند
// بكلمة مرور عندما نحفظها، ثم نحفظ المستند.
OdtSaveOptions saveOptions = new OdtSaveOptions(SaveFormat.Odt);
saveOptions.Password = "MyPassword";

doc.Save(ArtifactsDir + "File.DetectDocumentEncryption.odt", saveOptions);

// تحقق من نوع ملف وثيقتنا وحالة التشفير الخاصة به.
FileFormatInfo info = FileFormatUtil.DetectFileFormat(ArtifactsDir + "File.DetectDocumentEncryption.odt");

Assert.AreEqual(".odt", FileFormatUtil.LoadFormatToExtension(info.LoadFormat));
Assert.True(info.IsEncrypted);

يوضح كيفية استخدام فئة FileFormatUtil للكشف عن تنسيق المستند ووجود التوقيعات الرقمية.

// استخدم مثيل FileFormatInfo للتحقق من عدم توقيع المستند رقميًا.
FileFormatInfo info = FileFormatUtil.DetectFileFormat(MyDir + "Document.docx");

Assert.AreEqual(".docx", FileFormatUtil.LoadFormatToExtension(info.LoadFormat));
Assert.False(info.HasDigitalSignature);

CertificateHolder certificateHolder = CertificateHolder.Create(MyDir + "morzal.pfx", "aw", null);
DigitalSignatureUtil.Sign(MyDir + "Document.docx", ArtifactsDir + "File.DetectDigitalSignatures.docx",
    certificateHolder, new SignOptions() { SignTime = DateTime.Now });

// استخدم FileFormatInstance جديد لتأكيد توقيعه.
info = FileFormatUtil.DetectFileFormat(ArtifactsDir + "File.DetectDigitalSignatures.docx");

Assert.True(info.HasDigitalSignature);

// يمكننا تحميل التوقيعات الخاصة بالمستند الموقع في مجموعة كهذه والوصول إليها.
Assert.AreEqual(1, DigitalSignatureUtil.LoadSignatures(ArtifactsDir + "File.DetectDigitalSignatures.docx").Count);

أنظر أيضا

FileCorruptedException Class FileFormatUtil Class