---
description: .NET project guidance
globs: "**/*.cs, **/*.vb"
alwaysApply: false
---

# Aspose.Slides for .NET

Use these instructions for this platform only. Read the project's existing instructions and dependency files first. Keep its current package version unless the task requires a change. Confirm API names against this platform's documentation; bindings are not interchangeable.

## Setup

Install the NuGet package `Aspose.Slides.NET` for your project's target framework and operating system. Use the platform-specific instructions for native dependencies and fonts. C# types are in `Aspose.Slides`; output formats are in `Aspose.Slides.Export`. Dispose each `Presentation`, normally with a `using` block.

## Install for a local test

In a new .NET 8 console project, the verified package command is:

```sh
dotnet add package Aspose.Slides.NET --version 26.10.0
```

These pinned versions reproduce the example below. Preserve an existing project's dependency choices unless the user asks to change them.

## Minimal example

After installation, run this as `Program.cs` in your configured project. It creates `hello.pptx` in the working directory. Use a scratch directory so an existing file is not replaced.

```csharp
using Aspose.Slides;
using Aspose.Slides.Export;

using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];
    var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 80);
    shape.AddTextFrame("Hello, Aspose.Slides!");
    presentation.Save("hello.pptx", SaveFormat.Pptx);
}
```

Verified on 2026-11-18: Windows x64, .NET 8, Aspose.Slides.NET 26.10.0. The program ran and the saved file contained one slide with the expected text. This evaluation-mode check does not prove licensed output or other operating systems.

## License

Evaluation mode is suitable for a local smoke test and can add watermarks or other limits. If the user supplies a valid license, follow the [licensing guide](https://docs.aspose.com/slides/net/licensing/) before creating presentations. Read the license from a private local location accessible to the process. Never put license contents, keys, or personal paths in instructions, source control, or logs.

## Verify the change

Before expanding a change, create a small presentation, save it to a new file, and open the result. Check the requested content, slide count, and formatting. Build and run the exact code against the installed package; report any missing runtime or dependency instead of claiming it was tested.

Keep input files local unless the user permits sharing them. Write output to a new file and preserve the original. Report what ran, the versions used, and any checks that remain.

## Sources

- [Documentation](https://docs.aspose.com/slides/net/)
- [API reference](https://reference.aspose.com/slides/net/)
- [Installation](https://docs.aspose.com/slides/net/installation/)
- [Licensing](https://docs.aspose.com/slides/net/licensing/)
