Hızlı Başlangıç

Hızlı Başlangıç

Bu sayfa, en küçük çalışan örneği adım adım gösterir: bir dosyanın formatını ve başlık özelliklerini saptamak, ardından kütüphanenin bir hatalı dosyayı atmak yerine nasıl işlediğini görmek.


Dosyayı incele

ImageProbe tek statik giriş noktasıdır. ProbeFile, bir ImageInfo sonucunu doldurmak için dosya başlığından yeterli miktarı okur — piksel verilerini asla çözmez:

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 ve FrameCount öğelerini ortaya çıkarır — yalnızca algılanan format gerçekten bu verileri taşıyorsa doldurulur.


Bir akışı veya bayt dizisini incele

Probe, doğrudan bir Stream veya bir byte[] kabul eder ve DetectFormat, tam başlığa ihtiyacınız olmadığında yalnızca ImageFormat döndürür:

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

Kırpılmış veya hatalı girişin işlenmesi

ImageProbe hatalı veya kırpılmış girişte asla hata fırlatmaz. Bir istisna yükseltmek yerine, okuduğu alanlarla sınırlı bir ImageInfo döndürür — Format, başlığın format işaretçisi tanındığında her zaman ayarlanır, dosyanın geri kalanı kesilmiş olsa bile:

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

Bu, ImageProbe‘ı güvensiz veya kısmen indirilmiş dosyalar üzerinde, her çağrıyı try/catch içine almadan güvenli bir şekilde çalıştırmayı sağlar.


Sonraki Adımlar

Ayrıca Bakınız

 Türkçe