DetectFileFormat

DetectFileFormat(string)

يكتشف ويعيد المعلومات المتعلقة بتنسيق مستند مخزن في ملف قرص.

public static FileFormatInfo DetectFileFormat(string fileName)

معامل	يكتب	وصف
fileName	String	اسم الملف.

قيمة الإرجاع

أFileFormatInfo الكائن الذي يحتوي على المعلومات المكتشفة.

ملاحظات

حتى لو اكتشفت هذه الطريقة تنسيق المستند، فإنها لا تضمن أن المستند المحدد صالح. تكتشف هذه الطريقة تنسيق المستند فقط عن طريق قراءة البيانات الكافية للكشف . للتحقق بشكل كامل من صلاحية المستند ، يتعين عليك تحميل المستند في ملفDocument هدف.

يلقي هذا الأسلوبFileCorruptedException عندما يتم التعرف على التنسيق ، ولكن لا يمكن إكمال الكشف بسبب الفساد.

أمثلة

يوضح كيفية استخدام فئة 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);

أنظر أيضا

• class FileFormatInfo
• class FileFormatUtil
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words

---

DetectFileFormat(Stream)

يكتشف ويعيد المعلومات المتعلقة بتنسيق المستند المخزن في الدفق.

public static FileFormatInfo DetectFileFormat(Stream stream)

معامل	يكتب	وصف
stream	Stream	الدفق.

قيمة الإرجاع

أFileFormatInfo الكائن الذي يحتوي على المعلومات المكتشفة.

ملاحظات

يجب وضع الدفق في بداية المستند.

عندما تعود هذه الطريقة، تتم استعادة الموضع في الدفق إلى الموضع الأصلي.

حتى لو اكتشفت هذه الطريقة تنسيق المستند، فإنها لا تضمن أن المستند المحدد صالح. تكتشف هذه الطريقة تنسيق المستند فقط عن طريق قراءة البيانات الكافية للكشف . للتحقق بشكل كامل من صلاحية المستند ، يتعين عليك تحميل المستند في ملفDocument هدف.

يلقي هذا الأسلوبFileCorruptedException عندما يتم التعرف على التنسيق ، ولكن لا يمكن إكمال الكشف بسبب الفساد.

أمثلة

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

// قم بتحميل مستند من ملف يفتقد امتداد الملف، ثم اكتشف تنسيق الملف الخاص به.
using (FileStream docStream = File.OpenRead(MyDir + "Word document with missing file extension"))
{
    FileFormatInfo info = FileFormatUtil.DetectFileFormat(docStream);
    LoadFormat loadFormat = info.LoadFormat;

    Assert.AreEqual(LoadFormat.Doc, loadFormat);

    // فيما يلي طريقتان لتحويل LoadFormat إلى SaveFormat المطابق له.
    // 1 - احصل على سلسلة امتداد الملف لـ LoadFormat، ثم احصل على SaveFormat المقابل من تلك السلسلة:
    string fileExtension = FileFormatUtil.LoadFormatToExtension(loadFormat);
    SaveFormat saveFormat = FileFormatUtil.ExtensionToSaveFormat(fileExtension);

    // 2 - تحويل LoadFormat مباشرةً إلى SaveFormat الخاص به:
    saveFormat = FileFormatUtil.LoadFormatToSaveFormat(loadFormat);

    // قم بتحميل مستند من الدفق، ثم احفظه في ملحق الملف الذي تم اكتشافه تلقائيًا.
    Document doc = new Document(docStream);

    Assert.AreEqual(".doc", FileFormatUtil.SaveFormatToExtension(saveFormat));

    doc.Save(ArtifactsDir + "File.SaveToDetectedFileFormat" + FileFormatUtil.SaveFormatToExtension(saveFormat));
}

أنظر أيضا

• class FileFormatInfo
• class FileFormatUtil
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words