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 for .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 Aspose.Svg;
using System.IO;

// Save SVG to file using C#

// Prepare a path to save an SVG document
string documentPath = Path.Combine(OutputDir, "circles_out.svg");

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

    // Save SVG to a 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 Aspose.Svg;
using System.IO;

// Save SVG to Url using C#

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

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

    // Save the document to a 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;

// Save an SVG document along with its external resources in C#

// 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/saving/");

// Load an SVG document from a file
using (SVGDocument 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;

// Save SVG to a Zip Archive using C#

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

string dir = Directory.GetCurrentDirectory();

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

// Load an SVG document 
using (SVGDocument doc = new SVGDocument(inputPath))
{
    // Initialize an instance of the ZipResourceHandler class
    using (ZipResourceHandler 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 for .NET-Bibliothek zu verwalten:

// Custom resource handler to save SVG with resources into a ZIP archive

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)
    {
        string zipUri = (streamsCounter++ == 0
            ? Path.GetFileName(resource.OriginalUrl.Href)
            : Path.Combine(Path.GetFileName(Path.GetDirectoryName(resource.OriginalUrl.Href)),
                Path.GetFileName(resource.OriginalUrl.Href)));
        string samplePrefix = String.Empty;
        if (initialized)
            samplePrefix = "my_";
        else
            initialized = true;

        using (Stream 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;

// Save an SVG document to memory with a resource handler in C#

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

// Initialize an SVG document
using (SVGDocument doc = new SVGDocument(inputPath))
{
    // Create an instance of the MemoryResourceHandler class and save SVG to memory
    MemoryResourceHandler 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:

// Handle and save SVG resources to memory streams in C#

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)
    {
        MemoryStream 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 (Tuple<Stream, Resource> 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.