环境配置 – Aspose.SVG for .NET

环境配置的设置用于多种目的。例如，当您开发应用程序时，您肯定会需要一些配置，范围从运行时服务或处理来自应用程序的任何 Web 请求到注入自定义主题。

在本指南中，您将学习如何创建各种配置并使它们适应应用程序运行的不同环境。这可以是自定义主题、运行时服务或 Web 请求网络服务。

Aspose.Svg.Services 命名空间包含一组用于分离服务实现的接口。本文考虑不同类型的环境配置服务，例如用户代理服务、运行时服务和网络服务。 Aspose.SVG for .NET提供了 Configuration类，可用于设置应用程序运行的环境。

您可以从 GitHub 下载完整的示例和数据文件。您可以从 如何运行示例 部分了解如何从 GitHub 下载并运行示例。

用户代理服务 – User Agent Service

用户代理服务允许您指定自定义用户样式表、文档的主要字符集、语言和字体设置。您可以为特定文档选择自定义样式信息，并根据需要提供尽可能少或任意多的环境配置更改。

IUserAgentService 接口描述用户代理环境。

• IUserAgentService 接口的 UserStyleSheet 属性允许为特定文档指定样式信息；

• CharSet 属性设置文档的主要字符集。

  要正确解析和显示 SVG 文档，应用程序必须知道正在使用什么编码。如果未在文档标题中直接指定字符编码，Aspose.SVG 将使用默认定义的 UTF-8。但是，如果您确定您的 SVG 文档是使用与 UTF-8 编码不同的编码编写的，则可以手动指定它，如上面的示例所示。

• FontsSettings 属性用于字体处理的配置。当您需要使用自定义字体而不是操作系统上安装的字体时，您可以设置自定义文件夹的路径，如以下代码片段所示。

• CSSEngineMode 属性获取或设置 CSS 引擎的工作模式。

• Language 属性指定元素内容和任何包含文本的元素属性的主要语言。

考虑一个说明 UserStyleSheet、CharSet 和 FontsSettings 属性应用的示例：

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Services;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;

// Set custom user agent, styles, charset, and fonts for SVG conversion to PDF in C#

// Prepare SVG code and save it to a file
string code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
              "    <circle cx=\"40\" cy=\"80\" r=\"30\" />\r\n" +
              "    <text x=\"80\" y=\"100\">Aspose.SVG</text>\r\n" +
              "</svg>\r\n";

File.WriteAllText(Path.Combine(OutputDir, "user-agent.svg"), code);

// Create an instance of the Configuration class
using (Configuration configuration = new Configuration())
{
    // Get the IUserAgentService
    IUserAgentService userAgentService = configuration.GetService<IUserAgentService>();

    // Set a custom style parameters for <circle> and <text> elements
    userAgentService.UserStyleSheet = "circle { fill:silver; }\r\n" +
                                      "text { fill:DarkCyan; font-size:3em; }\r\n";

    // Set ISO-8859-1 encoding to parse a document
    userAgentService.CharSet = "ISO-8859-1";

    // Set a custom font folder path
    userAgentService.FontsSettings.SetFontsLookupFolder(Path.Combine(DataDir + "fonts"));

    // Initialize an SVG document with specified configuration
    using (SVGDocument document = new SVGDocument(Path.Combine(OutputDir, "user-agent.svg"), configuration))
    {
        // Convert SVG to PDF
        Converter.ConvertSVG(document, new PdfSaveOptions(), Path.Combine(OutputDir, "user-agent.pdf"));
    }
}

该图说明了 用户代理服务 将 (b) 应用于源 user-agent.svg 文件 (a) 的结果。

运行时服务 – Runtime Service

当计划运行应用程序时，您可能需要运行时服务配置。该服务使您可以控制内部流程的生命周期。例如，使用 IRuntimeService，您可以指定 JavaScript 的超时。如果脚本包含无限循环，那么设置这样的超时非常重要。下一个代码片段演示了如何使用超时。

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Services;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;

// Limit JavaScript execution time in SVG before conversion to PNG in C#

// Prepare SVG code and save it to a file
string code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
              "    <script> while(true) {} </script>\r\n" +
              "    <circle cx=\"40\" cy=\"80\" r=\"30\" />\r\n" +
              "</svg>\r\n";

File.WriteAllText(Path.Combine(OutputDir, "runtime.svg"), code);

// Create an instance of the Configuration class
using (Configuration configuration = new Configuration())
{
    // Limit JS execution time to 5 seconds
    IRuntimeService runtimeService = configuration.GetService<IRuntimeService>();
    runtimeService.JavaScriptTimeout = TimeSpan.FromSeconds(5);
                   
    // Initialize an SVG document with specified configuration
    using (SVGDocument document = new SVGDocument(Path.Combine(OutputDir, "runtime.svg"), configuration))
    {
        // Convert SVG to PNG
        Converter.ConvertSVG(document, new ImageSaveOptions(), Path.Combine(OutputDir, "runtime.png"));
    }
}

JavaScriptTimeout 属性设置 TimeSpan，它限制 JavaScript 的执行时间。如果脚本的执行时间超过了提供的 TimeSpan，它将被取消。默认值为 1 分钟。

网络服务 – Network Service

现代网络环境通过网络路由器和交换机、服务器、反恶意软件系统等生成大量安全事件和日志数据。

Aspose.SVG for .Net 提供了 INetworkService，它被设想为帮助管理和分析所有这些信息的解决方案。服务允许您控制所有传入/传出流量并实现自定义消息处理程序。它可用于不同的目的，例如创建自定义缓存机制、跟踪/记录请求消息等。

创建自定义消息处理程序

Aspose.SVG for .NET 提供了创建自定义消息处理程序的功能。让我们开发一个简单的自定义处理程序来记录有关无法访问的资源的信息。采取以下步骤：

1. 使用必要的命名空间，即 Aspose.Svg.Net。该命名空间由类和接口表示，负责帮助轻松进行网络处理。
2. 要创建自定义消息处理程序，您需要定义自己的类，该类将从 MessageHandler 类派生。我们构造一个 LogMessageHandler 类。
3. 重写 MessageHandler 类的 Invoke() 方法以实现自定义消息处理程序行为。

以下示例演示如何创建 LogMessageHandler 来记录有关无法访问的资源的信息。

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

// Сustom network message handler to log HTTP errors during SVG processing

// Define LogMessageHandler that is derived from the MessageHandler class
public class LogMessageHandler : MessageHandler
{
    private List<string> errors = new List<string>();

    public List<string> ErrorMessages
    {
        get { return errors; }
    }

    // Override the Invoke() method
    public override void Invoke(INetworkOperationContext context)
    {
        // Check whether response is OK
        if (context.Response.StatusCode != HttpStatusCode.OK)
        {
            // Set error information
            errors.Add(string.Format("File '{0}' Not Found", context.Request.RequestUri));
        }

        // Invoke the next message handler in the chain
        Next(context);
    }
}

有关创建自定义消息处理程序的更多信息，请参阅章节 消息处理程序。

使用 LogMessageHandler 记录有关无法访问的资源的信息

以下示例演示如何使用 LogMessageHandler 类来记录有关无法访问的资源的信息。

using System.IO;
using Aspose.Svg;
using Aspose.Svg.Services;
using Aspose.Svg.Converters;
using Aspose.Svg.Saving;
using Aspose.Svg.Net;

// Log network errors when loading external images in SVG and convert to PNG

// Prepare SVG code and save it to a file
string code = "<svg xmlns=\"http://www.w3.org/2000/svg\">\r\n" +
              "    <image href=\"https://docs.aspose.com/svg/images/drawing/park.jpg\" width=\"640px\" height=\"480px\" />\r\n" +
              "    <image href=\"https://docs.aspose.com/svg/net/missing1.svg\" width=\"400px\" height=\"300px\" />\r\n" +
              "    <image href=\"https://docs.aspose.com/svg/net/missing2.svg\" width=\"400px\" height=\"300px\" />\r\n" +
              "</svg>\r\n";

File.WriteAllText(Path.Combine(OutputDir, "network.svg"), code);

// Create an instance of the Configuration class
using (Configuration configuration = new Configuration())
{
    // Add LogMessageHandler to the chain of existing message handlers
    INetworkService networkService = configuration.GetService<INetworkService>();
    
    LogMessageHandler logHandler = new LogMessageHandler();
    networkService.MessageHandlers.Add(logHandler);

    // Initialize an SVG document with specified configuration
    using (SVGDocument document = new SVGDocument(Path.Combine(OutputDir, "network.svg"),  configuration))
    {
        // Convert SVG to PNG
        Converter.ConvertSVG(document, new ImageSaveOptions(), Path.Combine(OutputDir, "network.png"));

        // Print the List of ErrorMessages
        foreach (string errorMessage in logHandler.ErrorMessages)
        {
            Console.WriteLine(errorMessage);
        }
    }
}

示例运行后：

• 创建的文件 network.svg 将转换为 PNG。文件中只有一张图像；
• 将打印 ErrorMessages 列表：

File 'https://docs.aspose.com/svg/net/missing1.svg' Not Found
File 'https://docs.aspose.com/svg/net/missing2.svg' Not Found

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