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);
Info
Para sortear ciertas limitaciones al trabajar con flujos, Aspose.Slides puede copiar el contenido de un flujo. Cargar una presentación grande desde un flujo hace que la presentación se copie y puede ralentizar la carga. Por lo tanto, cuando necesite cargar una presentación grande, recomendamos encarecidamente usar la ruta del archivo de la presentación en lugar de un flujo.
Al crear una presentación que contiene objetos grandes (video, audio, imágenes de alta resolución, etc.), puede usar la gestión de BLOB para reducir el consumo de memoria.
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:
- proyecto VBA (accesible a través de IPresentation.VbaProject);
- datos incrustados de objeto OLE (accesibles a través de IOleEmbeddedDataInfo.EmbeddedFileData);
- datos binarios de control ActiveX (accesibles a través de IControl.ActiveXControlBinary).
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.