XML'in tamamına
ihtiyacınız yoksa,
tamamını yüklemeyin.

Signature ve Attachment gibi büyük alt ağaçları parse etmeden SkipAsync() ile atlayın.

XElement? invoice =
    await XmlSafeReader.ReadSectionWithExcludesAsync(
        "invoice.xml",
        new[] { "Invoice" },
        "Signature",
        "Attachment");
 
// Invoice
//  ├── Header
//  ├── Customer
//  ├── Lines
//  ├── Signature      ← çıkarılır
//  └── Attachment     ← çıkarılır

HTTP response, FileStream, MemoryStream veya database blob — hepsi aynı pipeline'dan geçer.

await using Stream stream = GetXmlStream();
 
XElement? result =
    await XmlSafeReader.ReadSectionAsElementAsync(
        stream,
        "Invoice");

Database binary alanları, web servis yanıtları veya SOAP mesajları için byte[]; doğrudan metin için string.

byte[] xmlBytes = GetXmlBytes();
 
XElement? fromBytes =
    await XmlSafeReader.ReadSectionAsElementAsync(
        xmlBytes,
        "Invoice");
 
// string XML — StringReader üzerinden XmlReader'a aktarılır
string xml = GetXml();
 
XElement? fromString =
    await XmlSafeReader.ReadSectionWithExcludesAsync(
        xml,
        new[] { "Invoice" });

Birden fazla hedef verin ya da aynı isimli elementleri tam XML path ile ayırt edin.

string[] targets = { "Invoice", "Customer", "Order" };
 
XElement? merged =
    await XmlSafeReader.ReadSectionWithExcludesAsync(
        "document.xml",
        targets);
 
// Envelope/Body/Invoice gibi tam path ile hedefleme
// aynı isimde farklı elementler arasında ayrım sağlar
XElement? scoped =
    await XmlSafeReader.ReadSectionWithExcludesFromPathAsync(
        "document.xml",
        new[] { "Envelope/Body/Invoice" });

Uygulama configuration XML'ini tamamen veya bölüm bazlı okuyun.

XElement settings =
    await XmlSafeReader.GetProjectSettingAsync();
 
// yalnızca connectionStrings bölümünü al
XElement? section =
    await XmlSafeReader.ReadSectionFromProjectSettingAsync(
        "connectionStrings");