Speichern Sie ein SVG-Dokument – ​​C#

Speichern Sie ein SVG-Dokument

Die meisten Aufgaben, die Sie ausführen müssen, erfordern das Speichern eines Dokuments. Sobald Sie die vorhandene Datei geladen oder ein SVG-Dokument von Grund auf erstellt haben, können Sie Ihre Änderungen mit einer der Methoden SVGDocument.Save() speichern. Es gibt überladene Methoden, die das Speichern von SVG in einer Datei, einem Stream, einem Zip-Archiv oder einer URL ermöglichen.

In diesem Artikel untersuchen wir die Speicherung von SVG-Dokumenten im gleichen Format. Sie erfahren, wie Sie Ihre SVG-Datei mit Save()-Methoden der Klasse SVGDocument speichern. Darüber hinaus stellt Aspose.SVG für .NET die Klasse ResourceHandler bereit, mit der SVG-Dokumente mit Ressourcen in Streams gespeichert und verwaltet werden können.

Die Szenarien zum Konvertieren und Rendern von SVG in andere Formate werden im Abschnitt So konvertieren Sie SVG-Dateien beschrieben.

SVG in einer Datei speichern

Der folgende Codeausschnitt demonstriert die Verwendung der Methode SVGDocument.Save() zum Speichern eines SVG-Dokuments in einer Datei:

using System.IO;
using Aspose.Svg;
...

    // Prepare a path for an SVG document saving
	string documentPath = Path.Combine(OutputDir, "lineto_out.svg");

    //  Load the SVG document from a file
    using (var document = new SVGDocument(Path.Combine(DataDir, "lineto.svg")))
    {
        // Work with the document

        // Save SVG to the file
        document.Save(documentPath);
    }

SVG unter einer URL speichern

Es ist notwendig, einen vollständigen URL-Pfad für das Speichern des Dokuments lineto.svg anzugeben und das url-Objekt an die Methode Save() zu übergeben, die das Dokument in einer durch URL angegebenen Datei speichert. Das folgende Codebeispiel zeigt, wie ein Dokument unter einer URL gespeichert wird:

using System.IO;
using Aspose.Svg;
...

    // Set a full path for an SVG document saving
	var url = new Url(Path.Combine(OutputDir, "lineto_out.svg"), Directory.GetCurrentDirectory());

    //  Load the SVG document from a file
    using (var document = new SVGDocument(Path.Combine(DataDir, "lineto.svg")))
    {
        // Work with the document
        
        // Save SVG to Url
        document.Save(url);
    }

Speichern Sie SVG in einem lokalen Dateisystemspeicher

Das SVG-Dokument kann verschiedene Ressourcen wie CSS, externe Bilder und Dateien enthalten. Aspose.SVG bietet eine Möglichkeit, SVG mit allen verknüpften Dateien zu speichern – die Klasse ResourceHandler wurde zum Speichern von SVG-Inhalten und -Ressourcen in Streams entwickelt. Diese Klasse ist für den Umgang mit Ressourcen verantwortlich und stellt Methoden bereit, mit denen Sie steuern können, was mit den einzelnen Ressourcen geschehen soll.

Betrachten wir ein Beispiel für das Speichern von SVG mit Ressourcen im vom Benutzer angegebenen lokalen Dateispeicher. Das Quelldokument with-resources.svg und die verknüpfte Bilddatei befinden sich im selben Verzeichnis. Der Konstruktor FileSystemResourceHandler(customOutDir) verwendet einen Pfad, der angibt, wo das Dokument mit den Ressourcen gespeichert wird, und erstellt ein FileSystemResourceHandler-Objekt. Die Methode Save(resourceHandler) nimmt dieses Objekt und speichert SVG im Ausgabespeicher.

using System.IO;
using Aspose.Svg.IO;
...

    // Prepare a path to a source SVG file
    string inputPath = Path.Combine(DataDir, "with-resources.svg");

    // Prepare a full path to an output directory 
    string customOutDir = Path.Combine(Directory.GetCurrentDirectory(), "./../../../../tests-out/save/");

    // Load the SVG document from a file
    using (var doc = new SVGDocument(inputPath))
    {
        // Save SVG with resources
        doc.Save(new FileSystemResourceHandler(customOutDir));
    }

Speichern Sie SVG in einem Zip-Archiv

Sie können den ResourceHandler implementieren, indem Sie die Klasse ZipResourceHandler erstellen. Die Methode HandleResource() in der Klasse ZipResourceHandler dient dazu, das Verhalten anzupassen, wie einzelne Ressourcen verarbeitet und in einem Zip-Archiv gespeichert werden. Sie können damit ein strukturiertes und komprimiertes Archiv erstellen, das SVG-Dokumente und zugehörige Ressourcen enthält, wodurch es sich für Szenarien wie Archivierung und Speicheroptimierung eignet.

Im folgenden Beispiel wird die Klasse ZipResourceHandler verwendet, um das Dokument with-resources.svg zusammen mit seinen verknüpften Ressourcen in einem Zip-Archiv zu speichern:

using System.IO;
using Aspose.Svg.IO;
using System.IO.Compression;
...

    // Prepare a path to a source SVG file 
    string inputPath = Path.Combine(DataDir, "with-resources.svg");

    var dir = Directory.GetCurrentDirectory();

    // Prepare a full path to an output Zip storage
    string customArchivePath = Path.Combine(dir, "./../../../../tests-out/save/archive.zip");

    // Load an SVG document 
    using (var doc = new SVGDocument(inputPath))
    {
        // Initialize an instance of the ZipResourceHandler class
        using (var resourceHandler = new ZipResourceHandler(customArchivePath))
        {
            // Save SVG with resources to a Zip archive
            doc.Save(resourceHandler);
        }
    }

Die Klasse ResourceHandler ist für die Kundenimplementierung vorgesehen. Die Klasse ZipResourceHandler erweitert die Basisklasse ResourceHandler und bietet eine praktische Möglichkeit, den gesamten Prozess der Handhabung und Speicherung von mit einem SVG-Dokument verknüpften Ressourcen in einem Zip-Archiv im Kontext der Aspose.SVG für .NET-Bibliothek zu verwalten:

    internal class ZipResourceHandler : ResourceHandler, IDisposable
    {
        private FileStream zipStream;
        private ZipArchive archive;
        private int streamsCounter;
        private bool initialized;

        public ZipResourceHandler(string name)
        {
            DisposeArchive();
            zipStream = new FileStream(name, FileMode.Create);
            archive = new ZipArchive(zipStream, ZipArchiveMode.Update);
            initialized = false;
        }

        public override void HandleResource(Resource resource, ResourceHandlingContext context)
        {
            var zipUri = (streamsCounter++ == 0
                ? Path.GetFileName(resource.OriginalUrl.Href)
                : Path.Combine(Path.GetFileName(Path.GetDirectoryName(resource.OriginalUrl.Href)),
                    Path.GetFileName(resource.OriginalUrl.Href)));
            var samplePrefix = String.Empty;
            if (initialized)
                samplePrefix = "my_";
            else
                initialized = true;

            using (var newStream = archive.CreateEntry(samplePrefix + zipUri).Open())
            {
                resource.WithOutputUrl(new Url("file:///" + samplePrefix + zipUri)).Save(newStream, context);
            }
        }

        private void DisposeArchive()
        {
            if (archive != null)
            {
                archive.Dispose();
                archive = null;
            }

            if (zipStream != null)
            {
                zipStream.Dispose();
                zipStream = null;
            }

            streamsCounter = 0;
        }

        public void Dispose()
        {
            DisposeArchive();
        }
    }

Speichern Sie SVG in Memory Streams

Die Klassenimplementierung ResourceHandler in der Klasse MemoryResourceHandler ermöglicht das Speichern von SVG in Speicherstreams. Der folgende Code zeigt, wie Sie mit der Klasse MemoryResourceHandler ein SVG-Dokument im Speicher speichern und Informationen über die verarbeiteten Ressourcen sammeln und drucken.

1. Initialisieren Sie ein SVG-Dokument mit dem angegebenen SVG-Dateipfad.
2. Erstellen Sie eine Instanz der Klasse MemoryResourceHandler. Diese Klasse dient zum Erfassen und Speichern von Ressourcen in Speicherströmen während des Ressourcenverarbeitungsprozesses.
3. Rufen Sie die Methode Save() des SVG-Dokuments auf und übergeben Sie ihr die Instanz MemoryResourceHandler als Argument. Dadurch wird die Ressourcenverwaltungslogik des MemoryResourceHandler mit dem SVG-Dokumentspeicherprozess verknüpft.
4. Verwenden Sie die Methode PrintInfo() des MemoryResourceHandler, um Informationen über die verwalteten Ressourcen auszudrucken.

using System.IO;
using Aspose.Svg.IO;
using System.Collections.Generic;
...

    // Prepare a path to a source SVG file
    string inputPath = Path.Combine(DataDir, "with-resources.svg");

    // Initialize an SVG document
    using (var doc = new SVGDocument(inputPath))
    {
        // Create an instance of the MemoryResourceHandler class and save SVG to memory
        var resourceHandler = new MemoryResourceHandler();
        doc.Save(resourceHandler);
        resourceHandler.PrintInfo();
    }

Nach dem Beispiellauf wird die Meldung zur Speicherbelegung ausgegeben:

uri:memory:///with-resources.svg, length:556
uri:memory:///photo.png, length:57438

Der ResourceHandler ist eine Basisklasse, die die Erstellung und Verwaltung von Ausgabestreams unterstützt. Mit der Klasse MemoryResourceHandler können Sie Ressourcen-In-Memory-Streams erfassen und speichern und so eine dynamische und flexible Möglichkeit bieten, mit Ressourcen umzugehen, ohne sie physisch im Dateisystem zu speichern. Der folgende Codeausschnitt zeigt die Realisierung von ResourceHandler in der Klasse MemoryResourceHandler:

    internal class MemoryResourceHandler : ResourceHandler
    {
        public List<Tuple<Stream, Resource>> Streams;

        public MemoryResourceHandler()
        {
            Streams = new List<Tuple<Stream, Resource>>();
        }

        public override void HandleResource(Resource resource, ResourceHandlingContext context)
        {
            var outputStream = new MemoryStream();
            Streams.Add(Tuple.Create<Stream, Resource>(outputStream, resource));
            resource
                .WithOutputUrl(new Url(Path.GetFileName(resource.OriginalUrl.Pathname), "memory:///"))
                .Save(outputStream, context);
        }

        public void PrintInfo()
        {
            foreach (var stream in Streams)
                Console.WriteLine($"uri:{stream.Item2.OutputUrl}, length:{stream.Item1.Length}");
        }
    }

Sie können die vollständigen Beispiele und Datendateien von GitHub herunterladen. Informationen zum Herunterladen von GitHub und zum Ausführen von Beispielen finden Sie im Abschnitt So führen Sie die Beispiele aus.

Sie können versuchen, SVG-Dokumente mit unserem Kostenlosen Online-SVG-Konverter in verschiedene andere Formate zu konvertieren.