Abrir presentaciones en .NET

De qué trata esta página

Aprenda a abrir presentaciones PowerPoint y OpenDocument en C#, proporcionar contraseñas de apertura, controlar la carga de recursos y reducir el uso de memoria con Aspose.Slides para .NET.

Introducción

Aspose.Slides for .NET puede cargar presentaciones PowerPoint y OpenDocument desde archivos y flujos. Después de cargar una presentación, puede inspeccionar su estructura, editar diapositivas, gestionar recursos y guardarla en el formato original u otro formato compatible.

El comportamiento de carga puede personalizarse mediante la clase LoadOptions. Por ejemplo, puede proporcionar una contraseña de apertura, mantener objetos binarios grandes fuera de la memoria gestionada, controlar recursos externos u omitir datos binarios incrustados.

Abrir presentaciones

Después de cargar un archivo o flujo, puede determinar su formato de presentación original para elegir cómo su aplicación lo procesa.

Para abrir una presentación existente, pase la ruta del archivo al constructor de Presentation. Libere la presentación después de usarla para que los manejadores de archivo, datos temporales y otros recursos se liberen rápidamente.

El siguiente ejemplo en C# muestra cómo abrir una presentación y obtener su número de diapositivas:

using System;
using Aspose.Slides;

using var presentation = new Presentation("sample.pptx");

Console.WriteLine("Slide count: " + presentation.Slides.Count);

Abrir presentaciones protegidas con contraseña

Una contraseña de apertura cifra el contenido de la presentación. Para cargar la presentación completa, asigne la contraseña correcta a LoadOptions.Password y pase las opciones al constructor de Presentation. La carga falla cuando la contraseña falta o es incorrecta.

using System;
using Aspose.Slides;

var loadOptions = new LoadOptions { Password = "open_password" };
using var presentation = new Presentation("encrypted-presentation.pptx", loadOptions);

Console.WriteLine("Slide count: " + presentation.Slides.Count);

Para la detección de contraseñas, validación y flujos de trabajo de cifrado, consulte Password-Protect Presentations. Si una presentación cifrada se guardó deliberadamente con propiedades de documento públicas, esas propiedades pueden leerse sin contraseña; vea Manage Presentation Properties.

Abrir presentaciones grandes

LoadOptions.BlobManagementOptions controla cómo Aspose.Slides gestiona objetos binarios grandes como imágenes, audio y vídeo. Puede mantener el archivo fuente bloqueado, permitir archivos temporales y limitar la cantidad de datos BLOB retenidos en memoria.

El siguiente código en C# demuestra cómo cargar una presentación grande (por ejemplo, 2 GB):

using Aspose.Slides;
using Aspose.Slides.Export;

const string filePath = "large-presentation.pptx";

var loadOptions = new LoadOptions
{
    BlobManagementOptions =
    {
        PresentationLockingBehavior = PresentationLockingBehavior.KeepLocked,
        IsTemporaryFilesAllowed = true,
        MaxBlobsBytesInMemory = 10 * 1024 * 1024
    }
};

using var presentation = new Presentation(filePath, loadOptions);

presentation.Slides[0].Name = "Large presentation";
presentation.Save("large-presentation-copy.pptx", SaveFormat.Pptx);

Note

Con PresentationLockingBehavior.KeepLocked, el archivo fuente permanece bloqueado hasta que se libere el objeto Presentation. No mueva, sobrescriba ni elimine el archivo fuente mientras ese objeto esté activo.

Aspose.Slides puede copiar el contenido de un flujo de entrada al cargarlo. Para presentaciones grandes, una ruta de archivo suele ser más eficiente que un flujo. Consulte Manage BLOBs para opciones adicionales de almacenamiento y gestión de memoria.

Controlar recursos externos

LoadOptions.ResourceLoadingCallback acepta una implementación de IResourceLoadingCallback. La devolución de llamada puede suministrar datos de sustitución, redirigir un recurso, usar el cargador predeterminado o omitir el recurso. Esto es útil cuando las presentaciones contienen imágenes externas que deben resolverse según reglas de seguridad o almacenamiento específicas de la aplicación.

using System;
using System.IO;
using Aspose.Slides;

internal static class OpenPresentationExample
{
    private static void Main()
    {
        var loadOptions = new LoadOptions
        {
            ResourceLoadingCallback = new ImageLoadingHandler()
        };

        using var presentation = new Presentation("presentation-with-external-images.pptx", loadOptions);
        Console.WriteLine("Slide count: " + presentation.Slides.Count);
    }

    private sealed class ImageLoadingHandler : IResourceLoadingCallback
    {
        public ResourceLoadingAction ResourceLoading(IResourceLoadingArgs args)
        {
            var isJpeg = args.OriginalUri.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase);
            if (!isJpeg || !File.Exists("approved-image.jpg"))
            {
                return ResourceLoadingAction.Skip;
            }

            var imageData = File.ReadAllBytes("approved-image.jpg");
            args.SetData(imageData);
            return ResourceLoadingAction.UserProvided;
        }
    }
}

Cargar presentaciones sin objetos binarios incrustados

Una presentación puede contener datos binarios incrustados que una aplicación no necesita o no desea conservar. Ejemplos incluyen:

• proyectos VBA, accesibles mediante IPresentation.VbaProject;
• datos OLE incrustados, accesibles mediante IOleEmbeddedDataInfo.EmbeddedFileData;
• datos de controles ActiveX, accesibles mediante IControl.ActiveXControlBinary.

Establezca LoadOptions.DeleteEmbeddedBinaryObjects en true para eliminar estos datos binarios durante la carga. Guarde la presentación cargada para conservar el resultado saneado.

Esta opción reduce la exposición a cargas útiles incrustadas no deseadas, pero no constituye un sistema completo de detección de malware o de saneamiento de contenido.

using Aspose.Slides;
using Aspose.Slides.Export;

var loadOptions = new LoadOptions
{
    DeleteEmbeddedBinaryObjects = true
};

using var presentation = new Presentation("presentation-with-embedded-data.pptx", loadOptions);

presentation.Save("presentation-without-embedded-data.pptx", SaveFormat.Pptx);

FAQ

¿Cómo puedo saber si un archivo está corrupto y no se puede abrir?

Aspose.Slides lanza una excepción de análisis o de formato durante la carga. Maneje esa falla por separado de un error de contraseña incorrecta para que la aplicación pueda informar la causa con precisión.

¿Qué ocurre si faltan fuentes requeridas?

La presentación aún puede cargarse, pero la representación y exportación pueden sustituir fuentes. Puede configurar la sustitución de fuentes o proporcionar fuentes personalizadas para que la salida sea más predecible.

¿La carga de una presentación también carga sus medios incrustados?

El audio y vídeo incrustados quedan disponibles a través del modelo de objetos de la presentación. Los recursos externos se resuelven según el comportamiento de carga de recursos configurado y pueden no estar disponibles si sus ubicaciones no pueden accederse.