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 aloneDit 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
- Installation — installatie van het pakket en omgevingsvereisten
- Ontwikkelaarsgids — de volledige formatdetectie API
- License — MIT-licentievoorwaarden