Aspose.Imaging FOSS
Getting Started
Schnellstart

Schnellstart

Schnellstart

Diese Seite führt das kleinste funktionierende Beispiel durch: Sie prüft eine Datei auf ihr Format und Header-Eigenschaften und zeigt dann, wie die Bibliothek mit einer beschädigten Datei umgeht, anstatt eine Ausnahme zu werfen.

Datei prüfen

ImageProbe ist der einzige statische Einstiegspunkt. ProbeFile liest gerade genug vom Dateikopf, um ein ImageInfo-Ergebnis zu füllen – es dekodiert niemals Pixeldaten:

using Aspose.Imaging.Foss;

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

ImageInfo stellt Format, Width, Height, BitDepth und FrameCount bereit – sie werden nur befüllt, wenn das erkannte Format diese Daten tatsächlich enthält.

Stream oder Byte-Array prüfen

Probe akzeptiert direkt ein Stream oder ein byte[], und DetectFormat gibt nur das ImageFormat zurück, wenn Sie den vollständigen Header nicht benötigen:

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

Umgang mit gekürzten oder fehlerhaften Eingaben

ImageProbe wirft bei fehlerhaftem oder gekürztem Input niemals eine Ausnahme. Statt eine Ausnahme auszulösen, gibt es ein partielles ImageInfo mit allen Feldern zurück, die es lesen konnte — Format wird immer gesetzt, wenn das Formatkennzeichen des Headers erkannt wurde, selbst wenn der Rest der Datei abgeschnitten ist:

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

Dadurch ist ImageProbe sicher gegenüber nicht vertrauenswürdigen oder teilweise heruntergeladenen Dateien einsetzbar, ohne jeden Aufruf in einen try/catch zu hüllen.

Nächste Schritte

Siehe auch

 Deutsch