Akışlar ve Async ile C#'ta Word Belgelerini Nasıl Yükleyip Kaydederim?

Ahmad Sohail
Ahmad Sohail
Güncellendi: 7 Ekim 2026

IronWord 2026.10.1+ her türlü System.IO.Stream ile doğrudan yüklemeyi ve kaydetmeyi ve her ikisi için de async yöntemlerini tanıtır. Önceden yükleme ve kaydetme dosya yolları ve bayt dizileri üzerinden çalışıyordu. Web yüklemesi olarak gelen bir .docx, blob depolamadan indirilen veya HTTP yanıtıyla geri çıkan diskle hiçbir zaman temas etmez. Böylece sunucusuz işlevler ve web uç noktaları tamamen hafızada kalır.

WordDocument için üç giriş noktası vardır: .docx diskteyken bir dosya yolu, baytlar zaten akıyorken bir akış ve her şey zaten hafızadayken bir bayt dizisi.

Hızlı başlangıç: Bir Akıştan Word Belgesini Yükleyin ve Kaydedin

Herhangi bir okunabilir akışı WordDocument yapıcına iletin ve ardından başka bir akışa kaydedin, akışlarla yükleme ve kaydetme örneği'nde olduğu gibi.

  1. 1IronWord ile NuGet Package Manager'u yükleyin

    PM > Install-Package IronWord

  2. 2Bu kod parçacığını kopyalayın ve çalıştırın.

    using var input = File.OpenRead("source.docx");
    var doc = new WordDocument(input);
    
    using var output = new MemoryStream();
    doc.Save(output);
    C#
  3. 3Canlı ortamınızda test için dağıtım yapın

    Projenizde IronWord'yi bugün ücretsiz deneme sürümü ile kullanmaya başlayın
    arrow pointer

Hangi Yükleme ve Kaydetme Aşımını Kullanmalıyım?

Verilerin nerede olduğunu bilen aşımı seçin.

YöntemYönG/ÇAsync
WordDocument(string filePath)YükleDosyaHayır
WordDocument(byte[] bytes)YükleNoneHayır
WordDocument(Stream stream)YükleAkışHayır
WordDocument.LoadAsync(string, CancellationToken)YükleDosyaEvet
WordDocument.LoadAsync(Stream, CancellationToken)YükleAkışEvet
Save(), byte[] dönerKaydetNoneHayır
Save(string filePath)KaydetDosyaHayır
Save(Stream stream)KaydetAkışHayır
SaveAs(string filePath)KaydetDosyaHayır
SaveAsync(string, CancellationToken)KaydetDosyaEvet
SaveAsync(Stream, CancellationToken)KaydetAkışEvet
SaveAsAsync(string, CancellationToken)KaydetDosyaEvet

Bayt dizileri tasarım gereği eşzamanlı kalır: bayt dizilerinden oluşturma ve bayt dizisine seri hale getirme herhangi bir G/Ç gerçekleştirmez, bu nedenle beklemeye gerek yoktur. Belgeleri tamamen hafızada üretmek ve bayt olarak almak için byte[] Save() çağırın.

Kaydetme, diğer tüm kaydetme yolları gibi, geçerli bir IronWord lisansı gerektirir.

Akış Sözleşmesi Nedir?

Beş kural, IronWord'un arayıcının akışını nasıl ele aldığını belirler.

  1. Akış sahipliği: IronWord hiçbir zaman arayanın akışını kapatmaz, bu yüzden arayan onun sahibidir ve onu bertaraf eder
  2. Yükleme: geçerli pozisyondan sonuna kadar okur ve akışı sonunda bırakır
  3. Kaydetme: geçerli pozisyonda yazar
  4. Kısaltma yok: önceden daha uzun bir belge tutan ve yeniden kullanılan bir akış, yeni içeriğin ardından eski ek baytını korur ve sonuç bozulmuş bir .docx olur. Bu yüzden kaydetmeden önce SetLength(0) ile sıfırlayın
  5. Geriye dönülemez akışlar: hem kaynak hem de hedef olarak desteklenir, çünkü ne yükleme ne de kaydetme aramalarında kullanım olmaz
using IronWord;
using IronWord.Models;

// Build a document entirely in memory
var doc = new WordDocument();
doc.AddParagraph(new Paragraph(new TextContent("Invoice #1042")));
doc.AddParagraph(new Paragraph(new TextContent("Total: $2,450.00")));

// Save to a MemoryStream
using var ms = new MemoryStream();
doc.Save(ms);

// Reset the position before handing the stream to another consumer
ms.Position = 0;

// Print the document size
Console.WriteLine($"Document size: {ms.Length} bytes");
C#

ASP.NET Core'da Akışları Nasıl Kullanabilirim?

ASP.NET Core: new WordDocument(Request.Body) ve doc.Save(Response.Body) Kestrel'in varsayılıyken hata verir, bu yüzden LoadAsync ve SaveAsync kullanın

Yüklenen Belge Nasıl Görünür?

Yükleme, bir başlık ve iki paragraf içeren kısa bir satıcı notudur.

Çeyrek Yıl Satıcı Notu başlıklı, iki paragraflı ve yükleme olarak uç noktaya gönderilen Word belgesi
using IronWord;
using IronWord.Models;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;

var app = WebApplication.Create();

// Upload a .docx, append a confidentiality notice, and return the modified document
app.MapPost("/add-notice", async (HttpRequest request) =>
{
    // Load the request body asynchronously
    var doc = await WordDocument.LoadAsync(request.Body);

    // Append a confidentiality notice
    doc.AddParagraph(new Paragraph(new TextContent("CONFIDENTIAL")));

    // Set the download headers
    var response = request.HttpContext.Response;
    response.ContentType =
        "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
    response.Headers.ContentDisposition = "attachment; filename=modified.docx";

    // Save to the response body asynchronously
    await doc.SaveAsync(response.Body);

    return Results.Empty;
});

app.Run();
C#

Uç Nokta Ne Döner?

Uç nokta arkasına eklenmiş bir CONFIDENTIAL paragrafı ile aynı notu döner.

Çeyrek Yıl Satıcı Notu başlıklı, sonuna GİZLİ bir paragraf eklenmiş olan uç nokta tarafından döndürülen Word belgesi

Async Yöntemler Gerçekten Ne Yapar?

Yalnızca dosya veya akış G/Ç'si eşzamansız ve iptal edilebilir. Yüklenen bir belgeyi çözümleme ve kaydedilen bir belgeyi serileştirme eşzamanlı, CPU'ya bağlı adımlardır ve CancellationToken kesintiye uğratamaz. Belirteç bu işten ve G/Ç çağrıları etrafında kontrol edilir.

Kaydetmeden Önce Raporun Görünümü Nasıldır?

report.docx bir başlık ve iki paragraf içerir.

Q3 İşlemler Raporu başlıklı, kaydetme işleminden önce iki paragraflı Word belgei report.docx
using IronWord;
using IronWord.Models;

// Load a document from disk asynchronously
var doc = await WordDocument.LoadAsync("report.docx");

// Append a dated paragraph
doc.AddParagraph(new Paragraph(
    new TextContent("Appendix added on " + DateTime.Now.ToString("yyyy-MM-dd"))));

// Save to a new path, leaving the original untouched
await doc.SaveAsAsync("report-updated.docx");
C#

Güncellenen Raporun Görünümü Nasıldır?

report-updated.docx tarihli ek satırını alır ve report.docx değişmeden kalır.

Bir Ek eklenmiş Q3 İşlemler Raporunu gösteren, eki yeni satır olarak eklenmiş olan Word belgei report-updated.docx

Dosya Kaydetme İçin İptal Güvenli mi?

İptal yalnızca belirteç çağrı başladığında zaten iptal edildiyse güvenlidir. Bu durumda, bir yol kaydetme hedef dosya açılmadan önce hata verir, bu yüzden mevcut bir dosya dokunulmadan kalır.

Yazma başladıktan sonra: İptal edilmiş bir kaydetme, dosyayı boş veya kısmen yazılmış, eski içerikleri kayıp ve bir akışı kısmen yazılmış olarak bırakabilir

WordDocument İş Parçacığına Güvenli mi?

Hayır. Tek bir WordDocument iş parçacığına güvenli değildir. Aynı örnek üzerinde kaydetme işlemlerini eşzamanlı çalıştırmayın: Task.WhenAll(doc.SaveAsync(pathA), doc.SaveAsync(pathB)) tanımsız davranış üretir.

Sıkça Sorulan Sorular

IronWord kullanarak C# dilinde bir Word belgesini bir akıştan nasıl yüklerim?

MemoryStream veya yüklenen bir dosya gibi okunabilir herhangi bir akışı WordDocument yapıcıya aktarın. IronWord, belgeden akışın mevcut konumundan sona doğru okur.

Bir Word belgesini IronWord ile bir akışa nasıl kaydedebilirim?

Dosyayı diske kaydetmeden belgeyi yazmak için MemoryStream gibi yazılabilir herhangi bir akış ile Save çağırın. IronWord, belgeyi akışın mevcut konumuna yazar.

C# dilinde Word belgelerini asenkron olarak yükleyip kaydedebilir miyim?

Evet. IronWord, dosya yolları ve akışlar için LoadAsync ve kaydetmek için SaveAsync ve SaveAsAsync sağlar, böylece async uygulama kodu bir dosya I/O üzerinde bir iş parçacığını bloke etmez.

IronWord bir belgeyi yükledikten veya kaydettikten sonra akışı kapatır mı?

Hayır. IronWord çağrıcıya ait bir akışı asla kapatmaz. Akışı açan uygulama ona sahiptir ve yok edilmesinden sorumludur.

Akışı yeniden kullandığımda kaydedilen Word belgem neden bozuk?

Zaten daha uzun bir belgeyi tutan bir akışa kaydetmek, eski son baytları yerinde bırakır ve bu da çıktıyı bozar. Yeniden kaydetmeden önce akışı sıfırlayın veya kesin.

IronWord bir belgeyi yüklerken veya kaydederken bir CancellationToken durdurabilir mi?

Jeton sadece dosya veya akış I/O'sunu iptal eder. Yüklenen bir belgeyi ayrıştırmak ve kaydedilen birini serileştirmek, jetonun kesemeyeceği eşzamanlı adımlardır.

IronWord'da byte dizilerini yüklemek veya kaydetmek için asenkron bir yöntem var mı?

Hayır, tasarım gereği. Bir byte dizisinden yükleme ve bir byte dizisine kaydetme I/O içermez, bu nedenle IronWord, bu bellek içi durumlar için eşzamanlı byte dizisi yapıcısı ve Save yöntemini korur.

IronWord'da bir WordDocument iş parçacığı güvenli midir?

Hayır. Tek bir WordDocument örneği iş parçacığı güvenli değildir, bu yüzden save işlemlerini aynı belgeye karşı eşzamanlı olarak çalıştırmayın, örneğin Task.WhenAll ile.

Bir yüklemeden, önce diske kaydetmeden bir Word belgesi yükleyebilir miyim?

Evet. Yüklemenin akışını doğrudan WordDocument yapıcısına veya LoadAsync'e aktarın, belgeyi bellek içi olarak düzenleyin ve dosya hiçbir zaman diske dokunmayacak şekilde yeniden bir akışa kaydedin.

Bir Word belgesini bir akışa kaydetmek bir IronWord lisansı gerektirir mi?

Evet. Bir akışa kaydetmek, bir dosya yoluna veya bir byte dizisine kaydetmekle aynı şekilde geçerli bir IronWord lisansı gerektirir.

Ahmad, C#, Python ve web teknolojilerinde sağlam bir temele sahip bir full-stack geliştiricidir. Gerçek dünyadaki uygulamalarda ölçeklenebilir yazılım çözümleri oluşturmaktan ve tasarım ile işlevselliğin nasıl buluştuğunu keşfetmekten derin bir ilgi duyar.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 62,392Sürüm:2026.11yeni çıktı