Abrir presentaciones en .NET

Visión general

Además de crear presentaciones de PowerPoint desde cero, Aspose.Slides también permite abrir presentaciones existentes. Después de cargar una presentación, puede obtener información sobre ella, editar el contenido de las diapositivas, agregar nuevas diapositivas, eliminar las existentes y mucho más.

Abrir presentaciones

Para abrir una presentación existente, instancie la clase Presentation y pase la ruta del archivo a su constructor.

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

// Instanciar la clase Presentation y pasar una ruta de archivo a su constructor.
using (Presentation presentation = new Presentation("Sample.pptx"))
{
    // Imprimir el número total de diapositivas en la presentación.
    System.Console.WriteLine(presentation.Slides.Count);
}

Abrir presentaciones protegidas con contraseña

Cuando necesite abrir una presentación protegida con contraseña, pase la contraseña a través de la propiedad Password de la clase LoadOptions para descifrarla y cargarla. El siguiente código en C# demuestra esta operación:

LoadOptions loadOptions = new LoadOptions {Password = "YOUR_PASSWORD"};
using (Presentation presentation = new Presentation("Sample.pptx", loadOptions))
{
    // Realizar operaciones en la presentación descifrada.
}

Abrir presentaciones grandes

Aspose.Slides proporciona opciones—en particular la propiedad BlobManagementOptions en la clase LoadOptions—para ayudarle a cargar presentaciones de gran tamaño.

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

const string filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions
{
    BlobManagementOptions = 
    {
        // Elija el comportamiento KeepLocked: el archivo de la presentación permanecerá bloqueado durante la vida de la instancia Presentation,
        // pero no necesita cargarse en memoria ni copiarse a un archivo temporal.
        PresentationLockingBehavior = PresentationLockingBehavior.KeepLocked,
        IsTemporaryFilesAllowed = true,
        MaxBlobsBytesInMemory = 10 * 1024 * 1024 // 10 MB
    }
};

using (Presentation presentation = new Presentation(filePath, loadOptions))
{
    // La gran presentación ha sido cargada y puede usarse, mientras el consumo de memoria se mantiene bajo.

    // Realice cambios en la presentación.
    presentation.Slides[0].Name = "Large presentation";

    // Guarde la presentación en otro archivo. El consumo de memoria se mantiene bajo durante esta operación.
    presentation.Save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // ¡No haga esto! Se lanzará una excepción de E/S porque el archivo está bloqueado hasta que se libere el objeto Presentation.
    File.Delete(filePath);
}

// Está bien hacerlo aquí. El archivo origen ya no está bloqueado por el objeto Presentation.
File.Delete(filePath);

Controlar recursos externos

Aspose.Slides proporciona la interfaz IResourceLoadingCallback que le permite gestionar recursos externos. El siguiente código en C# muestra cómo usar la interfaz IResourceLoadingCallback:

LoadOptions loadOptions = new LoadOptions();
loadOptions.ResourceLoadingCallback = new ImageLoadingHandler();

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
public class ImageLoadingHandler : IResourceLoadingCallback
{
    public ResourceLoadingAction ResourceLoading(IResourceLoadingArgs args)
    {
        if (args.OriginalUri.EndsWith(".jpg"))
        {
            try
            {
                // Cargar una imagen de sustitución.
                byte[] imageData = File.ReadAllBytes("aspose-logo.jpg");
                args.SetData(imageData);
                return ResourceLoadingAction.UserProvided;
            }
            catch (Exception)
            {
                return ResourceLoadingAction.Skip;
            }
        }
        else if (args.OriginalUri.EndsWith(".png"))
        {
            // Establecer una URL de sustitución.
            args.Uri = "http://www.google.com/images/logos/ps_logo2.png";
            return ResourceLoadingAction.Default;
        }

        // Omitir todas las demás imágenes.
        return ResourceLoadingAction.Skip;
    }
}

Cargar presentaciones sin objetos binarios incrustados

Una presentación de PowerPoint puede contener los siguientes tipos de objetos binarios incrustados:

Usando la propiedad ILoadOptions.DeleteEmbeddedBinaryObjects puede cargar una presentación sin ningún objeto binario incrustado.

Esta propiedad es útil para eliminar contenido binario potencialmente malicioso. El siguiente código en C# demuestra cómo cargar una presentación sin contenido binario incrustado:

LoadOptions loadOptions = new LoadOptions()
{
	DeleteEmbeddedBinaryObjects = true
}

using (Presentation presentation = new Presentation("malware.ppt", loadOptions))
{
    // Realizar operaciones en la presentación.
}

Preguntas frecuentes

¿Cómo puedo saber que un archivo está dañado y no se puede abrir?

Obtendrá una excepción de validación de análisis/ formato durante la carga. Estos errores a menudo mencionan una estructura ZIP no válida o registros de PowerPoint dañados.

¿Qué ocurre si faltan fuentes requeridas al abrir?

El archivo se abrirá, pero más adelante el renderizado/exportación puede sustituir fuentes. Configure sustituciones de fuentes o agregue las fuentes requeridas al entorno de ejecución.

¿Qué pasa con los medios incrustados (video/audio) al abrir?

Se convierten en recursos de la presentación. Si los medios se referencian mediante rutas externas, asegúrese de que esas rutas sean accesibles en su entorno; de lo contrario, el renderizado/exportación puede omitir los medios.