Snelstart

Snelstart

Deze pagina leidt je door het kleinste werkende voorbeeld: een bestand onderzoeken op zijn formaat en header-eigenschappen, en vervolgens zien hoe de bibliotheek een beschadigd bestand afhandelt in plaats van een uitzondering te werpen.


Onderzoek een bestand

ImageProbe is het enige statische toegangspunt. ProbeFile leest net genoeg van de bestandsheader om een ImageInfo resultaat te vullen — het decodeert nooit pixeldata:

using Aspose.Imaging.Foss;

var info = ImageProbe.ProbeFile("photo.jpg");
Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}, {info.BitDepth}-bit");

ImageInfo biedt Format, Width, Height, BitDepth en FrameCount — alleen gevuld wanneer het gedetecteerde formaat die gegevens daadwerkelijk bevat.


Onderzoek een stream of byte-array

Probe accepteert rechtstreeks een Stream of een byte[], en DetectFormat retourneert alleen de ImageFormat wanneer je de volledige header niet nodig hebt:

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);

Omgaan met afgekorte of onjuiste invoer

ImageProbe gooit nooit een uitzondering bij onjuiste of afgekorte invoer. In plaats van een exceptie te werpen, geeft het een gedeeltelijke ImageInfo terug met alle velden die het heeft kunnen lezen — Format wordt altijd ingesteld wanneer de formatmarker van de header werd herkend, zelfs als de rest van het bestand te kort is:

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

Dit maakt ImageProbe veilig om uit te voeren op niet-vertrouwde of gedeeltelijk gedownloade bestanden zonder elke oproep in een try/catch te wikkelen.


Volgende stappen

Zie ook

 Nederlands