Start rapid
Începe rapid
Această pagină parcurge cel mai mic exemplu funcțional: investigarea unui fișier pentru formatul și proprietățile antetului, apoi observarea modului în care biblioteca gestionează un fișier deteriorat în loc să arunce.
Probează un fișier
ImageProbe este singurul punct de intrare static. ProbeFile citește exact atât din antetul fișierului pentru a popula un rezultat ImageInfo — nu decodează niciodată datele pixel:
using Aspose.Imaging.Foss;
var info = ImageProbe.ProbeFile("photo.jpg");
Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}, {info.BitDepth}-bit");ImageInfo expune Format, Width, Height, BitDepth și FrameCount — completate numai când formatul detectat conține efectiv acele date.
Probează un flux sau un tablou de octeţi
Probe acceptă direct un Stream sau un byte[], iar DetectFormat returnează doar ImageFormat când nu ai nevoie de antetul complet:
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);Gestionarea intrării trunchiate sau defectuoase
ImageProbe nu aruncă niciodată la intrări defectuoase sau trunchiate. În loc să ridice o excepție, returnează un ImageInfo parțial cu orice câmpuri a reușit să citească — Format este întotdeauna setat când markerul de format al antetului a fost recunoscut, chiar dacă restul fișierului este tăiat:
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 aloneAcest lucru face ca ImageProbe să fie sigur de rulat pe fișiere neîncredere sau parțial descărcate fără a înfășura fiecare apel într-un try/catch.
Pași următori
- Installation — configurarea pachetului și cerințele de mediu
- Ghid pentru dezvoltatori — detectarea completă a formatului API
- License — termenii licenței MIT