Aspose.SVG for .NET 24.3.0 – 将 SVG 保存到流

Aspose.SVG for .NET 24.3.0

在版本 24.3.0 中，IOutputStorage 接口和 LocalFileSystemStorage 类已弃用，但在版本 24.6.0 发布之前将继续有效。如果您使用早期版本的 Aspose.SVG for .NET，我们建议您升级并迁移到新版本，因为版本 24.6.0 将删除这些已弃用的类。

Deprecated	New
IOutputStorage Interface	ResourceHandler Class
LocalFileSystemStorage Class	FileSystemResourceHandler Class

SVG 文档可以包含不同的资源，例如 CSS、外部图像和文件。在本文中，我们将考虑将带有资源的 SVG 文档保存到 Zip 存档、内存流和本地文件系统存储的情况。 Aspose.SVG for .NET 继续开发和增强使用所有链接文件保存 SVG 的方法。在这里，我们将查看使用已弃用的类保存文件的示例，并提供用于实现新类的高级解决方案。

ResourceHandler类对比IOutputStorage接口

ResourceHandler 类允许开发人员实现 HandleResource() 方法，在该方法中您可以自己创建一个流并在需要的地方释放它。新方法增加了查看Resource并处理有关它的更多信息的能力。因此，通过采用ResourceHandler类，开发人员可以从更简化和更具表现力的资源管理方法中受益，从而在保存 SVG 文档时生成更清晰、更易于维护和灵活的代码。

将 SVG 保存到 Zip 存档

在这里，我们将研究一个使用过时的IOutputStorage接口和新的ResourceHandler类将 with-resources.svg 文件保存在 Zip 存档中的示例。

使用 IOutputStorage – 24.2.0 及更早版本

IOutputStorage接口是支持输出流的创建和管理的基本接口。您可以通过创建 ZipStorage 类来实现 IOutputStorage 接口，以将带有资源的 SVG 保存到 Zip 存档中：

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/old/archive.zip");

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

以下代码片段显示了 ZipStorage 类中IOutputStorage的实现，以演示如何将包含资源的 SVG 文档保存到 Zip 存档中。

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

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

        public OutputStream CreateStream(OutputStreamContext context)
        {
            var zipUri = (streamsCounter++ == 0 ? Path.GetFileName(context.Uri) :
                Path.Combine(Path.GetFileName(Path.GetDirectoryName(context.Uri)), Path.GetFileName(context.Uri)));
            var samplePrefix = String.Empty;
            if (initialized)
                samplePrefix = "my_";
            else
                initialized = true;

            var newStream = archive.CreateEntry(samplePrefix + zipUri).Open();
            var outputStream = new OutputStream(newStream, "file:///" + samplePrefix + zipUri);
            return outputStream;
        }

        public void ReleaseStream(OutputStream stream)
        {
            stream.Flush();
            stream.Close();
        }

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

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

使用新的 ResourceHandler 类 – 自版本 24.3.0 起

ResourceHandler 类供客户实现。以下 C# 示例展示了如何使用 ResourceHandler 的 ZipResourceHandler 类将包含资源的 SVG 文档保存到 Zip 存档：

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/new/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);
        }
    }

以下代码片段显示了 ZipResourceHandler 类中 ResourceHandler 的实现，以演示如何将包含资源的 SVG 文档保存到 Zip 存档。 ZipResourceHandler 类的 HandleResource() 方法负责在创建 Zip 存档时的保存过程中处理每个资源：

// 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();
    }
}

将 SVG 保存到内存流

让我们考虑使用已弃用的IOutputStorage接口和新的 ResourceHandler 类将带有链接资源的 SVG 文件保存到内存流的 C# 示例。源 with-resources.svg 文档和链接的图像文件位于同一目录中。

使用 IOutputStorage – 24.2.0 及更早版本

IOutputStorage接口实现允许将 SVG 保存到内存流：

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

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

示例运行后，将打印有关内存存储的消息：

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

以下代码片段显示了 MemoryOutputStorage 类中IOutputStorage的实现，以演示将 SVG 文档保存到内存流。

    internal class MemoryOutputStorage : IOutputStorage
    {
        public List<Tuple<OutputStream, string>> Streams;

        public MemoryOutputStorage()
        {
            Streams = new List<Tuple<OutputStream, string>>();
        }

        public OutputStream CreateStream(OutputStreamContext context)
        {
            var normalizedPath = new Url(context.Uri).Pathname;
            var uri = new Url(Path.GetFileName(normalizedPath), "memory:///").Href;
            var outputStream = new OutputStream(new MemoryStream(), uri);
            Streams.Add(Tuple.Create(outputStream, uri));
            return outputStream;
        }

        public void ReleaseStream(OutputStream stream)
        {
            stream.Flush();
        }

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

使用新的 ResourceHandler 类 – 自版本 24.3.0 起

以下代码片段显示了 MemoryResourceHandler 类中 ResourceHandler 的实现，以演示将 SVG 文档保存到内存流：

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

现在，不再是在IOutputStorage接口的 MemoryOutputStorage 类中实现的CreateStream()和ReleaseStream()方法，而是在IOutputStorage的MemoryResourceHandler类中实现了一种 HandleResource() 方法。 ResourceHandler类，您可以在其中自己创建流并在需要的地方释放它。新方法增加了查看Resource并处理有关它的更多信息的能力：

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

正如您所看到的，新方法直接使用Resource对象进行操作，无需使用OutputStream等其他类。这简化了代码并使与资源的交互更加明确和易于理解。因此，在将 SVG 文档保存到内存流时，ResourceHandler基类提供了一种更加简化和更具表现力的资源处理方式。

示例运行后，将打印有关内存存储的消息：

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

FileSystemResourceHandler 类与 LocalFileSystemStorage 类

与 LocalFileSystemStorage 类不同，新的 FileSystemResourceHandler 类不仅允许您将 SVG 文档和资源保存到选定的文件夹，而且还可以通过 ResourceHandler 基类的方法来控制将父文件中的链接写入到您正在保存的文件。

将 SVG 保存到本地文件系统存储

在这里，我们将检查使用已弃用的LocalFileSystemStorage类和新的FileSystemResourceHandler类将 SVG 文件 with-resources.svg 保存到本地文件系统存储的相同示例。

使用 LocalFileSystemStorage 类 – 24.2.0 及更早版本

源 SVG 文档与链接的图像文件位于同一目录中。 LocalFileSystemStorage(customOutDir) 构造函数创建一个文件系统存储对象。 Save(IOutputStorage) 方法获取此对象并将 SVG 保存到输出存储。

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

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

使用 FileSystemResourceHandler 类 – 自版本 24.3.0 起

FileSystemResourceHandler 类是 Aspose.SVG for .NET 中 ResourceHandler 类的实现。该类专门为将资源保存到本地文件系统而设计，为保存 SVG 文档时管理资源提供了方便且可扩展的解决方案。以下代码片段演示了FileSystemResourceHandler类的使用：

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

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

FileSystemResourceHandler(customOutDir) 构造函数采用指示资源保存位置的路径并创建 FileSystemResourceHandler 对象。 Save(resourceHandler) 方法获取该对象并将 SVG 保存到输出存储。

您可以从 GitHub 下载完整的示例和数据文件。关于从 GitHub 下载并运行示例，您可以从 如何运行示例 部分找到。

您可以尝试使用我们的 免费在线 SVG 转换器 将 SVG 文档转换为各种其他格式。