Configuration de l'environnement – ​​Aspose.SVG for .NET

Le paramètre de configuration de l’environnement est utilisé à diverses fins. Par exemple, lorsque vous développez une application, vous exigerez certainement une configuration pouvant aller du service d’exécution ou gérer toutes les requêtes Web de l’application à l’injection de thèmes personnalisés.

Dans ce guide, vous apprendrez à créer diverses configurations et à les adapter aux différents environnements dans lesquels l’application s’exécute. Il peut s’agir d’un thème personnalisé, d’un service d’exécution ou d’un service réseau de requête Web.

L’espace de noms Aspose.Svg.Services contient un ensemble d’interfaces pour les implémentations de services séparés. Cet article considère différents types de services de configuration d’environnement, tels que le Service d’agent utilisateur, le Service d’exécution et le Service réseau. Aspose.SVG for .NET fournit la classe Configuration qui peut être utilisée pour définir l’environnement dans lequel l’application est exécutée.

Vous pouvez télécharger les exemples complets et les fichiers de données depuis GitHub. Vous découvrirez le téléchargement depuis GitHub et l’exécution d’exemples dans la section Comment exécuter les exemples.

Service d’agent utilisateur – User Agent Service

Le User Agent Service vous permet de spécifier une feuille de style utilisateur personnalisée, un jeu de caractères principal pour les paramètres du document, de la langue et des polices. Vous pouvez sélectionner vos informations de style personnalisé pour un document particulier et fournir autant de modifications de configuration d’environnement que nécessaire.

L’interface IUserAgentService décrit un environnement d’agent utilisateur.

• La propriété UserStyleSheet de l’interface IUserAgentService permet de spécifier des informations de style pour un document particulier ;

• La propriété CharSet définit le jeu de caractères principal d’un document.

  Pour analyser et afficher correctement un document SVG, l’application doit savoir quel encodage est utilisé. Si le codage des caractères n’est pas directement spécifié dans l’en-tête du document, Aspose.SVG utilise UTF-8, qui est défini par défaut. Cependant, si vous êtes sûr que votre document SVG est écrit avec un encodage différent de celui UTF-8, vous pouvez le spécifier manuellement, comme indiqué dans l’exemple ci-dessus.

• La propriété FontsSettings est utilisée pour la configuration de la gestion des polices. Lorsque vous devez utiliser les polices personnalisées au lieu des polices installées sur le système d’exploitation, vous pouvez définir le chemin d’accès à votre dossier personnalisé, comme indiqué dans l’extrait de code suivant.

• La propriété CSSEngineMode obtient ou définit le mode dans lequel fonctionne le moteur CSS.

• La propriété Language spécifie la langue principale du contenu de l’élément et de tout attribut de l’élément contenant du texte.

Prenons un exemple qui illustre l’application des propriétés UserStyleSheet, CharSet et 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"));
    }
}

La figure illustre le résultat de l’application du User Agent Service (b) au fichier source user-agent.svg (a).

Service d’exécution – Runtime Service

Lorsque vous prévoyez d’exécuter votre application, vous aurez peut-être besoin d’une configuration de service d’exécution. Ce service vous permet de contrôler la durée de vie des processus internes. Par exemple, en utilisant IRuntimeService, vous pouvez spécifier des délais d’attente pour les JavaScript. Il est important d’avoir un tel délai d’attente au cas où un script contiendrait une boucle sans fin. L’extrait de code suivant montre comment utiliser les délais d’attente.

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

La propriété JavaScriptTimeout définit TimeSpan, qui limite le temps d’exécution de JavaScript. Si le script est exécuté plus longtemps que le TimeSpan fourni, il sera annulé. La valeur par défaut est 1 minute.

Service réseau – Network Service

Les environnements réseau modernes génèrent une quantité importante d’événements de sécurité et enregistrent des données via des routeurs et commutateurs réseau, des serveurs, des systèmes anti-malware, etc.

Aspose.SVG for .NET propose le INetworkService qui est envisagé comme une solution pour aider à gérer et analyser toutes ces informations. Le service vous permet de contrôler tout le trafic entrant/sortant et de mettre en œuvre vos gestionnaires de messages personnalisés. Il peut être utilisé à différentes fins, telles que la création d’un mécanisme de mise en cache personnalisé, le traçage/journalisation des messages de demande, etc.

Créer un gestionnaire de messages personnalisé

Aspose.SVG for .NET offre des fonctionnalités pour la création de gestionnaires de messages personnalisés. Développons un gestionnaire personnalisé simple qui enregistre les informations sur les ressources inaccessibles. Suivez les étapes suivantes :

1. Utilisez l’espace de noms nécessaire, qui est Aspose.Svg.Net. Cet espace de noms est présenté par des classes et des interfaces, qui sont chargées de faciliter le traitement du réseau.
2. Pour créer un gestionnaire de messages personnalisé, vous devez définir votre propre classe qui sera dérivée de la classe MessageHandler. Nous construisons une classe LogMessageHandler.
3. Remplacez la méthode Invoke() de la classe MessageHandler pour implémenter le comportement du gestionnaire de messages personnalisé.

L’exemple suivant montre comment créer LogMessageHandler pour enregistrer des informations sur les ressources inaccessibles.

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

Pour plus d’informations sur la création de gestionnaires de messages personnalisés, veuillez consulter le chapitre Message Handlers.

Utilisez LogMessageHandler pour enregistrer des informations sur les ressources inaccessibles

L’exemple suivant montre comment utiliser la classe LogMessageHandler pour consigner des informations sur les ressources inaccessibles.

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

Après l’exécution de l’exemple:

• le fichier créé “network.svg” sera converti en PNG. Une seule image se trouve dans le fichier;
• la Liste des ErrorMessages sera imprimée :

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

Vous pouvez télécharger les exemples complets et les fichiers de données depuis GitHub. À propos du téléchargement depuis GitHub et de l’exécution d’exemples, vous le découvrirez dans la section Comment exécuter les exemples.