Snabbstart
Snabbstart
Den här sidan går igenom det minsta fungerande exemplet: att undersöka en fil för dess format och header-egenskaper, och sedan se hur biblioteket hanterar en skadad fil i stället för att kasta ett undantag.
Undersök en fil
ImageProbe är den enda statiska ingångspunkten. ProbeFile läser bara tillräckligt med filheader för att fylla i ett ImageInfo-resultat — den avkodar aldrig pixeldata:
using Aspose.Imaging.Foss;
var info = ImageProbe.ProbeFile("photo.jpg");
Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}, {info.BitDepth}-bit");ImageInfo exponerar Format, Width, Height, BitDepth och FrameCount — fylls i endast när det upptäckta formatet faktiskt innehåller den datan.
Undersök en ström eller byte-array
Probe accepterar en Stream eller en byte[] direkt, och DetectFormat returnerar bara ImageFormat när du inte behöver hela headern:
using Aspose.Imaging.Foss;
using System.IO;
byte[] bytes = File.ReadAllBytes("photo.jpg");
var format = ImageProbe.DetectFormat(bytes);
using var stream = File.OpenRead("photo.jpg");
var info = ImageProbe.Probe(stream);Hantera trunkerad eller felaktig indata
ImageProbe kastar aldrig ett undantag vid felaktig eller trunkerad indata. Istället för att höja ett undantag returnerar den ett partiellt ImageInfo med de fält den lyckades läsa — Format sätts alltid när headerns formatmarkör känns igen, även om resten av filen är avklippt:
using Aspose.Imaging.Foss;
byte[] truncated = fullGifBytes[..^2]; // last two bytes missing
var info = ImageProbe.Probe(truncated);
Console.WriteLine(info.Format); // Gif — detected from the header aloneDetta gör ImageProbe säkert att köra mot opålitliga eller delvis nedladdade filer utan att omsluta varje anrop i en try/catch.
Nästa steg
- Installation — paketinstallation och miljökrav
- Utvecklarguide — den fullständiga formatdetektionen API
- License — MIT-licensvillkor