Cómo comenzar con Aspose.Slides FOSS para .NET

Aspose.Slides.Foss para .NET es una biblioteca gratuita, con licencia MIT, para crear y editar archivos PowerPoint .pptx — no se requiere Microsoft Office, disponible en NuGet.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar desde NuGet (se requiere .NET 9.0 o posterior):

dotnet add package Aspose.Slides.Foss

Verifique la instalación compilando el proyecto:

dotnet build

Paso 2: Importar los espacios de nombres requeridos

Agrega las directivas using que necesitas para cargar presentaciones y guardarlas:

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

Paso 3: Crear una presentación

Construya un Presentation sin argumentos para comenzar con una diapositiva en blanco. Siempre use using para garantizar que se liberen los recursos internos:

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

using var prs = new Presentation();
Console.WriteLine($"Slides: {prs.Slides.Count}");
prs.Save("new_presentation.pptx", SaveFormat.Pptx);

Paso 4: Añadir una forma con texto

Utilice slide.Shapes.AddAutoShape() para insertar un rectángulo, luego llame a AddTextFrame() para agregar contenido de texto:

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

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 150);
var tf = shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 24;
fmt.FontBold = NullableBool.True;
prs.Save("with_shape.pptx", SaveFormat.Pptx);

Paso 5: Aplicar un relleno y guardar

Establezca un color de relleno sólido en la forma antes de guardar:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 200);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 70, 130, 180);
shape.AddTextFrame("Styled shape");
prs.Save("styled.pptx", SaveFormat.Pptx);

Problemas comunes y soluciones

TypeLoadException o DllNotFoundException
Asegúrese de que está apuntando a .NET 9.0 o posterior. La biblioteca requiere .NET 9.0+. Actualice su
.csproj archivo: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException al llamar a ciertos métodos
Algunas características (gráficos, animaciones, exportación a PDF) no son compatibles con esta versión.
Consulte la referencia de la API para obtener una lista de limitaciones antes de usar funciones avanzadas.

ObjectDisposedException después del bloque using
No utilice una instancia Presentation fuera de su bloque using. Acceda a todas las diapositivas,
formas y marcos de texto antes de que el bloque using finalice.

Archivo no guardado correctamente Siempre pase un valor de enumeración SaveFormat a Save(). La sobrecarga Save(path, SaveFormat.Pptx) escribe un archivo en formato PPTX.

Preguntas Frecuentes

¿Aspose.Slides.Foss requiere Microsoft Office?

No. La biblioteca crea y lee archivos .pptx de forma nativa en C# puro sin dependencia de Microsoft Office, COM automation o Windows APIs.

¿Qué versiones de .NET son compatibles?

.NET 9.0 o posterior. La biblioteca se ejecuta en Windows, macOS, Linux y contenedores Docker.

¿La biblioteca es gratuita para uso comercial?

Sí. Está publicado bajo la Licencia MIT. Puede usar, modificar y redistribuirlo para cualquier propósito, incluidas aplicaciones comerciales.

¿Puedo cargar un archivo PPTX existente?

Sí. Pase la ruta del archivo al constructor Presentation:

using var prs = new Presentation("existing.pptx");
Console.WriteLine($"Loaded {prs.Slides.Count} slides");
prs.Save("copy.pptx", SaveFormat.Pptx);

¿Necesito llamar a Dispose explícitamente?

Sí, a través de la declaración using. Presentation implementa IDisposable y debe ser eliminado para liberar los manejadores de archivo y los recursos internos.