Convertir MHTML en XPS – C#

La conversion de MHTML en XPS est souvent nécessaire pour tirer parti du format XPS dans le cadre de tâches spécifiques. Un fichier XPS représente des fichiers de mise en page basés sur les spécifications XML pour le papier, créées par Microsoft.

Dans cet article, vous trouverez des informations sur la manière de convertir MHTML en XPS à l’aide des méthodes ConvertMHTML() de la classe Converter et sur la manière d’appliquer les paramètres XpsSaveOptions et ICreateStreamProvider.

Convertisseur MHTML en ligne

Vous pouvez vérifier la fonctionnalité de l’API Aspose.HTML et convertir du MHTML en temps réel. Veuillez charger un fichier MHTML à partir du système de fichiers local, sélectionnez le format de sortie et exécutez l’exemple. Dans l’exemple, les options d’enregistrement sont définies par défaut. Vous recevrez immédiatement le résultat dans un fichier séparé.

Si vous souhaitez convertir MHTML au format XPS par programme, veuillez consulter les exemples de code C# suivants.

MHTML vers XPS en deux lignes de code

Les méthodes statiques de la classe Converter sont principalement utilisées comme moyen le plus simple de convertir un code MHTML en différents formats. Par exemple, vous pouvez convertir MHTML en XPS dans votre application C# en deux lignes de code !

// Convert MHTML to XPS using C#

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Invoke the ConvertMHTML() method to convert the MHTML code to XPS
Converter.ConvertMHTML(stream, new XpsSaveOptions(), Path.Combine(OutputDir, "convert-by-two-lines.xps"));

Convertir MHTML en XPS

L’utilisation des méthodes Converter.ConvertMHTML() est le moyen le plus courant de convertir du code MHTML dans différents formats. Avec Aspose.HTML, vous pouvez convertir du code MHTML au format XPS de manière programmatique, avec un contrôle total sur un large éventail de paramètres de conversion.

L’extrait de code C# suivant montre comment convertir du MHTML en XPS à l’aide d’Aspose.HTML for .NET.

1. Ouvrir un fichier MHTML existant. Dans l’exemple, nous utilisons la méthode OpenRead() de la classe System.IO.FileStream pour ouvrir et lire des fichiers à partir du système de fichiers au chemin spécifié.
2. Créer une instance de la classe XpsSaveOptions.
3. Utilisez la méthode ConvertMHTML() de la classe Converter pour enregistrer le MHTML en tant que fichier XPS. Vous devez transmettre le flux du fichier MHTML, les options XpsSaveOptions et le chemin du fichier de sortie à la méthode ConvertMHTML() pour la conversion MHTML vers XPS.

// Convert MHTML to XPS in C#

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Prepare a path for converted file saving 
string savePath = Path.Combine(OutputDir, "sample-output.xps");

// Create an instance of XpsSaveOptions
XpsSaveOptions options = new XpsSaveOptions();

// Call the ConvertMHTML() method to convert MHTML to XPS
Converter.ConvertMHTML(stream, options, savePath);

Vous pouvez télécharger les exemples complets et les fichiers de données sur GitHub.

Sauvegarder les options

Aspose.HTML permet de convertir du MHTML en XPS en utilisant des options d’enregistrement par défaut ou personnalisées. l’utilisation de XpsSaveOptions vous permet de personnaliser le processus de rendu ; vous pouvez spécifier la taille de la page, les marges, la couleur d’arrière-plan, les résolutions, etc.

Property	Description
PageSetup	This property gets a page setup object and uses it for configuration output page-set.
Css	Gets a CssOptions object which is used for configuration of CSS properties processing.
BackgroundColor	This property sets the color that will fill the background of every page. By default, this property is Transparent.
HorizontalResolution	Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolution	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.

Pour en savoir plus sur XpsSaveOptions, veuillez lire l’article Convertisseurs à réglage fin.

Convertir MHTML en XPS à l’aide de XpsSaveOptions

Pour convertir MHTML en XPS en spécifiant XpsSaveOptions, vous devez suivre quelques étapes :

1. Ouvrir un fichier MHTML existant.
2. Créer un nouvel objet XpsSaveOptions et spécifier les options de sauvegarde.
3. Utilisez la méthode ConvertMHTML() pour enregistrer du MHTML en tant que fichier XPS. Vous devez transmettre le flux du fichier MHTML, les options XpsSaveOptions et le chemin du fichier de sortie à la méthode ConvertMHTML() pour la conversion MHTML vers XPS.

L’exemple suivant montre comment utiliser XpsSaveOptions et créer un fichier XPS avec des options d’enregistrement personnalisées :

// Convert MHTML to XPS in C# with custom settings

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Prepare a path for converted file saving 
string savePath = Path.Combine(OutputDir, "sample-options.xps");

// Create an instance of XpsSaveOptions. Set up the page-size and change the background color to AliceBlue 
XpsSaveOptions options = new XpsSaveOptions();
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(Length.FromInches(8.3f), Length.FromInches(5.8f)));
options.BackgroundColor = System.Drawing.Color.AliceBlue;

// Call the ConvertMHTML() method to convert MHTML to XPS
Converter.ConvertMHTML(stream, options, savePath);

Dans l’exemple, nous utilisons la méthode OpenRead() de la classe System.IO.FileStream pour ouvrir et lire les fichiers source à partir du système de fichiers au chemin spécifié. Le constructeur XpsSaveOptions() initialise une instance de la classe XpsSaveOptions qui est transmise à la méthode ConvertMHTML(). La méthode ConvertMHTML() prend le stream, les options, le chemin du fichier de sortie savePath et effectue l’opération de conversion. La classe XpsSaveOptions fournit de nombreuses propriétés qui vous donnent un contrôle total sur un large éventail de paramètres et améliorent le processus de conversion du MHTML au format XPS.

Dans l’exemple ci-dessus, nous utilisons :

• propriété BackgroundColor qui spécifie la couleur dans laquelle l’arrière-plan sera rempli. La couleur d’arrière-plan par défaut est Transparent.
• propriété PageSetup qui spécifie la page size en pixels.

Fournisseurs de flux de sortie

S’il est nécessaire d’enregistrer des fichiers dans un espace de stockage distant (par exemple, un nuage, une base de données, etc.), vous pouvez mettre en œuvre l’interface ICreateStreamProvider afin de contrôler manuellement le processus de création de fichiers. Cette interface est conçue comme un objet de rappel pour créer un flux au début du document/de la page (en fonction du format de sortie) et libérer le flux créé au début après le rendu du document/de la page.

Aspose.HTML for .NET fournit différents types de formats de sortie pour les opérations de rendu. Certains de ces formats produisent un seul fichier de sortie (par exemple PDF, XPS), d’autres créent plusieurs fichiers (formats d’image JPG, PNG, etc.)

L’exemple ci-dessous montre comment mettre en œuvre et utiliser votre propre MemoryStreamProvider dans l’application :

// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (MemoryStream stream in Streams)
            stream.Dispose();
    }
}

// Convert MHTML to XPS in C# using memory stream

// Create an instance of MemoryStreamProvider
using MemoryStreamProvider streamProvider = new MemoryStreamProvider();

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Prepare a path for converted file saving
string savePath = Path.Combine(OutputDir, "stream-provider.xps");

// Convert MHTML to XPS by using the MemoryStreamProvider class
Converter.ConvertMHTML(stream, new XpsSaveOptions(), streamProvider);

// Get access to the memory stream that contains the result data
MemoryStream memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(savePath))
{
    memory.CopyTo(fs);
}

Aspose.HTML propose un Convertisseur MHTML vers XPS en ligne gratuit qui convertit les fichiers MHTML en fichiers XPS avec une grande qualité, facilement et rapidement. Il suffit de télécharger, de convertir vos fichiers et d’obtenir des résultats en quelques secondes !