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 alone

Detta 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

Se även

 Svenska