เริ่มต้นอย่างรวดเร็ว
เริ่มต้นอย่างรวดเร็ว
หน้านี้อธิบายตัวอย่างที่ทำงานได้เล็กที่สุด: ตรวจสอบไฟล์เพื่อหาฟอร์แมตและคุณสมบัติของส่วนหัว, จากนั้นดูว่าห้องสมุดจัดการไฟล์ที่เสียหายอย่างไรแทนการโยนข้อผิดพลาด.
ตรวจสอบไฟล์
ImageProbe เป็นจุดเข้าคงที่เพียงจุดเดียว. ProbeFile อ่านส่วนหัวของไฟล์เพียงพอเพื่อเติมผลลัพธ์ ImageInfo — มันไม่เคยถอดรหัสข้อมูลพิกเซลเลย:
using Aspose.Imaging.Foss;
var info = ImageProbe.ProbeFile("photo.jpg");
Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}, {info.BitDepth}-bit");ImageInfo เปิดเผย Format, Width, Height, BitDepth และ FrameCount — จะถูกเติมค่าเฉพาะเมื่อฟอร์แมตที่ตรวจพบจริง ๆ มีข้อมูลนั้น.
ตรวจสอบสตรีมหรืออาร์เรย์ไบต์
Probe ยอมรับ Stream หรือ byte[] โดยตรง, และ DetectFormat จะคืนค่า ImageFormat เท่านั้นเมื่อคุณไม่ต้องการส่วนหัวเต็ม:
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);การจัดการอินพุตที่ถูกตัดหรือรูปแบบไม่ถูกต้อง
ImageProbe ไม่เคยโยนข้อยกเว้นเมื่ออินพุตมีรูปแบบไม่ถูกต้องหรือถูกตัด. แทนที่จะยกข้อยกเว้น, มันจะคืนค่า ImageInfo ส่วนหนึ่งพร้อมกับฟิลด์ใด ๆ ที่มันสามารถอ่านได้ — Format จะถูกตั้งค่าตลอดเวลาเมื่อเครื่องหมายรูปแบบของส่วนหัวถูกจดจำ, แม้ว่าไฟล์ส่วนที่เหลือจะถูกตัดสั้นลง:
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สิ่งนี้ทำให้ ImageProbe ปลอดภัยต่อการทำงานกับไฟล์ที่ไม่เชื่อถือหรือที่ดาวน์โหลดมาเพียงบางส่วนโดยไม่ต้องห่อหุ้มแต่ละการเรียกใน try/catch.
ขั้นตอนต่อไป
- Installation — การตั้งค่าแพ็กเกจและความต้องการของสภาพแวดล้อม
- คู่มือผู้พัฒนา — การตรวจจับรูปแบบเต็ม API
- License — เงื่อนไขใบอนุญาต MIT
