Aspose.Slides FOSS for .NET ile Nasıl Başlanır

Aspose.Slides.Foss for .NET, PowerPoint .pptx dosyalarını oluşturmak ve düzenlemek için ücretsiz, MIT lisanslı bir kütüphanedir — Microsoft Office gerekmez, NuGet üzerinden temin edilebilir.

Adım Adım Kılavuz

Adım 1: Paketi Yükleyin

NuGet’ten yükleyin (.NET 9.0 veya daha yeni bir sürüm gereklidir):

dotnet add package Aspose.Slides.Foss

Kurulumu, projeyi derleyerek doğrulayın:

dotnet build

Adım 2: Gerekli Ad Alanlarını İçe Aktarın

Sunumları yüklemek ve kaydetmek için ihtiyacınız olan using yönergelerini ekleyin:

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

Adım 3: Sunum Oluştur

Bir boş slaytla başlamak için hiçbir argüman olmadan bir Presentation oluşturun. İç kaynakların serbest bırakıldığından emin olmak için her zaman using kullanın:

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);

Adım 4: Metinli Bir Şekil Ekle

slide.Shapes.AddAutoShape() kullanarak bir dikdörtgen ekleyin, ardından AddTextFrame() çağırarak metin içeriği ekleyin:

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);

Adım 5: Dolgu Uygula ve Kaydet

Kaydetmeden önce şekle katı dolgu rengi ayarlayın:

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);

Yaygın Sorunlar ve Çözümler

TypeLoadException or DllNotFoundException
Hedeflediğiniz .NET 9.0 veya daha yeni bir sürüm olduğundan emin olun. Kütüphane .NET 9.0+ gerektirir. Güncelleyin
.csproj dosyanızı: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException belirli yöntemleri çağırırken
Bu sürümde bazı özellikler (grafikler, animasyonlar, PDF dışa aktarımı) desteklenmiyor.
Gelişmiş özellikleri kullanmadan önce sınırlamaların bir listesini görmek için API referansına bakın.

ObjectDisposedException using bloğundan sonra
Presentation örneğini, using bloğunun dışına kullanmayın. Tüm slaytlara,
şekillere ve metin çerçevelerine using bloğu çıkmadan önce erişin.

Dosya doğru kaydedilmedi
Always pass a SaveFormat enum value to Save(). The overload Save(path, SaveFormat.Pptx)
writes a PPTX-format file.

Sıkça Sorulan Sorular

Aspose.Slides.Foss Microsoft Office gerektirir mi?

Hayır. Kütüphane, Microsoft Office, COM otomasyonu veya Windows API’lerine bağımlı olmadan saf C# ile yerel olarak .pptx dosyalarını oluşturur ve okur.

Hangi .NET sürümleri destekleniyor?

.NET 9.0 ve üzeri. Kütüphane Windows, macOS, Linux ve Docker konteynerlerinde çalışır.

Kütüphane ticari kullanım için ücretsiz mi?

Evet. MIT Lisansı altında yayınlanmıştır. Herhangi bir amaç için, ticari uygulamalar da dahil olmak üzere, kullanabilir, değiştirebilir ve yeniden dağıtabilirsiniz.

Mevcut bir PPTX dosyasını yükleyebilir miyim?

Evet. Dosya yolunu Presentation yapıcısına geçirin:

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

Dispose’i açıkça çağırmam gerekiyor mu?

Evet, using ifadesi aracılığıyla. Presentation, IDisposable‘yi uygular ve atılmalıdır
dosya tanıtıcılarını ve dahili kaynakları serbest bırakmak için.