Kern API

Kern-API

Aspose.Imaging FOSS für die gesamte öffentliche Oberfläche von .NET besteht aus drei Klassen: ImageProbe (die statische Fassade), ImageInfo (der Ergebniswert), und ImageFormat (das Format-Enum). Diese Seite erklärt, wie sie zusammen als Vertrag passen, über die Feature-für-Feature-Tour hinaus in Funktionen und Funktionalitäten.

Der Drei-Klassen-Vertrag

• ImageProbe — statisch, zustandslos. Jeder Aufruf ist unabhängig; es gibt nichts zu konfigurieren oder zu entsorgen.
• ImageInfo — versiegelt, unveränderlich. Alle fünf Eigenschaften (Format, Width, Height, BitDepth, FrameCount) sind nach der Konstruktion schreibgeschützt.
• ImageFormat — ein Enum mit einem Wert pro erkanntem Format, plus Unknown.

using Aspose.Imaging.Foss;

var info = ImageProbe.ProbeFile("photo.jpg");
ImageFormat format = info.Format;   // always set
int? width = info.Width;            // set only when the format's header carries it

Direktes Erzeugen von ImageInfo

Der Konstruktor von ImageInfo ist öffentlich — nur format ist erforderlich, jeder andere Parameter hat standardmäßig den Wert null. Das ist nützlich für Unit-Tests, die ein Ersatz-Ergebnis benötigen, ohne eine echte Datei zu untersuchen:

using Aspose.Imaging.Foss;

// Fake a PNG result for a test double, with no dimensions
var fakeInfo = new ImageInfo(ImageFormat.Png);

// Fake a fully-populated result
var fullInfo = new ImageInfo(ImageFormat.Gif, width: 64, height: 48, bitDepth: 8, frameCount: 3);

Es gibt keinen entsprechenden Weg, um mutate an ImageInfo nach der Konstruktion — jede Eigenschaft ist schreibgeschützt, sodass eine abgefragte oder konstruierte Instanz sicher weitergegeben und zwischengespeichert werden kann, ohne defensive Kopien zu erstellen.

Die richtige Überladung wählen

ProbeFile öffnet und liest die Datei selbst — es ist nicht nötig, zuerst ein FileStream zu öffnen, nur um Probe(stream) aufzurufen.

Batch-Abfrage eines Verzeichnisses

Da ImageProbe niemals eine Ausnahme wirft, kann ein Verzeichnis-Scan es in einer engen Schleife aufrufen, ohne für jede Datei try/catch zu verwenden:

using Aspose.Imaging.Foss;

foreach (var path in Directory.GetFiles("incoming"))
{
    var info = ImageProbe.ProbeFile(path);

    if (info.Format == ImageFormat.Unknown)
    {
        Console.WriteLine($"{path}: not a recognized image format, skipping");
        continue;
    }

    Console.WriteLine($"{path}: {info.Format} {info.Width}x{info.Height}");
}

Jede Datei, deren Header nicht zu einem der 11 erkannten Formate passt, wird zu ImageFormat.Unknown aufgelöst, anstatt eine Ausnahme zu werfen — die obige Schleife benötigt niemals einen Catch-Block.

Der nie-auswerfende Vertrag

Dies ist kein zufälliges Verhalten — es ist ein bewusstes Element des API-Vertrags. Wenn der Header eines erkannten Formats während des Parsens abgeschnitten oder fehlerhaft ist, gibt ImageProbe immer noch ein ImageInfo zurück, bei dem Format auf das erkannte Format gesetzt ist; es propagiert keine Parse-Ausnahme an den Aufrufer. Nur Format ist garantiert — behandeln Sie jede andere Eigenschaft als optional, unabhängig davon, welches Format erkannt wurde.

Häufige Probleme

FAQ

Kann ich ImageInfo oder ImageProbe unterklassen?

Nein. ImageInfo ist sealed und ImageProbe ist static — keiner ist für Unterklassenbildung oder Instanziierung via Vererbung vorgesehen.

Ist ImageProbe thread-sicher?

ImageProbe hält keinen veränderbaren Zustand zwischen Aufrufen — jeder Aufruf von Probe, ProbeFile oder DetectFormat ist unabhängig, sodass gleichzeitige Aufrufe aus mehreren Threads sicher sind.

Muss ich etwas freigeben?

Nein. ImageProbe hat keine eigenen IDisposable-Ressourcen. Wenn Sie ein Stream übergeben, das Sie selbst geöffnet haben, bleiben Sie für das Freigeben dieses Streams verantwortlich — Probe(stream) schließt ihn nicht.

API Reference Zusammenfassung

Siehe auch

• Aspose.Imaging — Enterprise Documentation