DetectFileFormat

DetectFileFormat(string)

Upptäcker och returnerar information om formatet för ett dokument som lagras i en diskfil.

public static FileFormatInfo DetectFileFormat(string fileName)
ParameterTypBeskrivning
fileNameStringFilnamnet.

Returvärde

EnFileFormatInfo objekt som innehåller den detekterade informationen.

Anmärkningar

Även om den här metoden identifierar dokumentformatet garanterar den inte att det angivna dokumentet är giltigt. Den här metoden identifierar endast dokumentformatet genom att läsa data som är tillräckliga för detektering. För att fullständigt verifiera att ett dokument är giltigt måste du läsa in dokumentet i enDocument objekt.

Den här metoden kastarFileCorruptedException när formatet is igenkänns, men detekteringen inte kan slutföras på grund av korruption.

Exempel

Visar hur man använder FileFormatUtil-klassen för att identifiera dokumentformat och kryptering.

Document doc = new Document();

// Konfigurera ett SaveOptions-objekt för att kryptera dokumentet
// med ett lösenord när vi sparar det, och sedan sparar vi dokumentet.
OdtSaveOptions saveOptions = new OdtSaveOptions(SaveFormat.Odt);
saveOptions.Password = "MyPassword";

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

// Verifiera filtypen för vårt dokument och dess krypteringsstatus.
FileFormatInfo info = FileFormatUtil.DetectFileFormat(ArtifactsDir + "File.DetectDocumentEncryption.odt");

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

Visar hur man använder FileFormatUtil-klassen för att identifiera dokumentformat och förekomst av digitala signaturer.

// Använd en FileFormatInfo-instans för att verifiera att ett dokument inte är digitalt signerat.
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);
SignOptions signOptions = new SignOptions() { SignTime = DateTime.Now };
DigitalSignatureUtil.Sign(MyDir + "Document.docx", ArtifactsDir + "File.DetectDigitalSignatures.docx",
    certificateHolder, signOptions);

// Använd en ny FileFormatInstance för att bekräfta att den är signerad.
info = FileFormatUtil.DetectFileFormat(ArtifactsDir + "File.DetectDigitalSignatures.docx");

Assert.True(info.HasDigitalSignature);

// Vi kan ladda och komma åt signaturerna för ett signerat dokument i en samling som denna.
Assert.AreEqual(1, DigitalSignatureUtil.LoadSignatures(ArtifactsDir + "File.DetectDigitalSignatures.docx").Count);

Se även

DetectFileFormat(Stream)

Upptäcker och returnerar information om formatet för ett dokument som lagras i en ström.

public static FileFormatInfo DetectFileFormat(Stream stream)
ParameterTypBeskrivning
streamStreamStrömmen.

Returvärde

EnFileFormatInfo objekt som innehåller den detekterade informationen.

Anmärkningar

Strömmen måste placeras i början av dokumentet.

När den här metoden återgår återställs positionen i strömmen till den ursprungliga positionen.

Även om den här metoden identifierar dokumentformatet garanterar den inte att det angivna dokumentet är giltigt. Den här metoden identifierar endast dokumentformatet genom att läsa data som är tillräckliga för detektering. För att fullständigt verifiera att ett dokument är giltigt måste du läsa in dokumentet i enDocument objekt.

Den här metoden kastarFileCorruptedException när formatet is igenkänns, men detekteringen inte kan slutföras på grund av korruption.

Exempel

Visar hur man använder FileFormatUtil-metoderna för att identifiera ett dokuments format.

// Ladda ett dokument från en fil som saknar filändelse och identifiera sedan dess filformat.
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);

    // Nedan följer två metoder för att konvertera ett LoadFormat till motsvarande SaveFormat.
    // 1 - Hämta filändelsen för LoadFormat och hämta sedan motsvarande SaveFormat från den strängen:
    string fileExtension = FileFormatUtil.LoadFormatToExtension(loadFormat);
    SaveFormat saveFormat = FileFormatUtil.ExtensionToSaveFormat(fileExtension);

    // 2 - Konvertera LoadFormat direkt till dess SaveFormat:
    saveFormat = FileFormatUtil.LoadFormatToSaveFormat(loadFormat);

    // Ladda ett dokument från strömmen och spara det sedan till den automatiskt upptäckta filändelsen.
    Document doc = new Document(docStream);

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

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

Se även

FileFormatUtil.ContentTypeToSaveFormat FileFormatUtil.ExtensionToSaveFormat