Convertir EPUB en XPS en C#

Dans cet article, vous trouverez des informations sur la manière de convertir EPUB en XPS et sur l’utilisation des paramètres XpsSaveOptions et ICreateStreamProvider.

Convertisseur EPUB en ligne

Vous pouvez vérifier la fonctionnalité de l’API Aspose.HTML for .NET et convertir des EPUB en temps réel. Veuillez charger un fichier EPUB à 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 sous la forme d’un fichier séparé.

Si vous souhaitez convertir EPUB en XPS par programme, veuillez consulter les exemples de code C# suivants.

EPUB 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 fichier EPUB dans différents formats. Vous pouvez convertir EPUB en XPS dans votre application C# en deux lignes de code !

// Convert EPUB to XPS using C#

// Open an existing EPUB file for reading
using FileStream stream = File.OpenRead(DataDir + "input.epub");

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

Convertir EPUB en XPS

Pour convertir EPUB en XPS, vous devez suivre quelques étapes :

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

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

// Convert EPUB to XPS in C#

// Open an existing EPUB file for reading
using FileStream stream = File.OpenRead(DataDir + "input.epub");

// Prepare a path to save the converted file 
string savePath = Path.Combine(OutputDir, "input-output.xps");

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

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

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

Sauvegarder les options

Avec Aspose.HTML, vous pouvez convertir EPUB au format XPS de manière programmatique en contrôlant totalement un large éventail de paramètres de conversion. l’utilisation de XpsSaveOptions vous permet de régler le processus de rendu ; vous pouvez spécifier la taille de la page, les marges, les feuilles de style CSS, 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 EPUB en XPS à l’aide de XpsSaveOptions

Aspose.HTML permet de convertir un EPUB en XPS en utilisant des options d’enregistrement par défaut ou personnalisées. Vous devez suivre quelques étapes :

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

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

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

// Open an existing EPUB file for reading
using FileStream stream = File.OpenRead(DataDir + "input.epub");

// Prepare a path to save the converted file 
string savePath = Path.Combine(OutputDir, "input-options.xps");

// Create an instance of XpsSaveOptions. Set up the page-size and change the background color to LightGray 
XpsSaveOptions options = new XpsSaveOptions()
{
    PageSetup =
        {
            AnyPage = new Page()
            {
                Size = new Aspose.Html.Drawing.Size(Length.FromPixels(500), Length.FromPixels(500))
            }
        },
    BackgroundColor = System.Drawing.Color.LightGray
};

// Call the ConvertEPUB() method to convert EPUB to XPS
Converter.ConvertEPUB(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 ConvertEPUB(). La méthode ConvertEPUB() 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 EPUB vers XPS.

Dans l’exemple, nous utilisons :

• la 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.

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.)

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.

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 EPUB to XPS in C# using memory stream

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

// Open an existing EPUB file for reading
using FileStream stream = File.OpenRead(DataDir + "input.epub");

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

// Convert EPUB to XPS by using the MemoryStreamProvider class
Converter.ConvertEPUB(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);
}

La méthode ConvertEPUB(Stream, XpsSaveOptions, ICreateStreamProvider) prend la source de conversion, les options, et l’instance de MemoryStreamProvider, qui sera utilisée pour obtenir un flux de sortie, et effectue l’opération de conversion.

Aspose.HTML propose un Convertisseur EPUB en XPS gratuit en ligne qui convertit les fichiers EPUB 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 !