FileFormatInfo

FileFormatInfo class

包含由返回的数据FileFormatUtil文档格式检测方法.

public class FileFormatInfo

特性

姓名 描述
Encoding { get; } 如果适用于当前文档格式，则获取检测到的编码。 目前仅检测 HTML 文档的编码。
HasDigitalSignature { get; } 如果此文档包含数字签名，则返回 true。 此属性仅告知文档上存在数字签名， ，但并未指定签名是否有效。
IsEncrypted { get; } 如果文档已加密并且需要密码才能打开，则返回 true。
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 FileFormatUtil