Metin ile .NET içinde Çalışma
Bu kılavuz, Aspose.Words FOSS için .NET içinde metinle nasıl çalışılacağını gösterir: bir koşunun yazı tipini biçimlendirme, bir paragrafı biçimlendirme, Range kullanarak metni bulma ve değiştirme, yorum ekleme ve bir paragrafı liste öğesine dönüştürme. Aspose.Words FOSS için .NET, NuGet üzerinden ya da kaynak koddan derlenerek temin edilebilir.
Adım Adım Kılavuz
Adım 1: Kütüphaneyi Edinin
Depoyu klonlayın ve derleyin Aspose.Words.sln Release yapılandırmasında, ardından bir proje başvurusu ekleyin Aspose.Words.csproj kendi .NET projenizden, aşağıda açıklanan Kurulum kılavuzu. Ekleyin using Aspose.Words; metinle çalışan herhangi bir dosyanın en üstüne.
Adım 2: Bir Koşunun Yazı Tipini Biçimlendirin
Bir Run, aynı biçimlendirme kümesini paylaşan bir metin aralığıdır; Text özelliği düz metin içeriğini tutar ve Font özelliği (bir Font nesnesi) karakter seviyesinde biçimlendirmeyi tutar — Name, Size, Bold, Italic, Underline, Color, HighlightColor, Subscript/Superscript ve StrikeThrough gibi diğerleri. Font.ClearFormatting(), bir koşuyu varsayılanlara sıfırlar. Bir paragraftaki koşular, Runs özelliği aracılığıyla, bir RunCollection üzerinden erişilebilir. Yeni metin yazmadan önce DocumentBuilder.Font üzerinde yazı tipi özelliklerini ayarlamak, sonradan bireysel Run nesnelerini biçimlendirmekten genellikle daha basittir.
Adım 3: Bir Paragrafı Biçimlendir
Paragraph.ParagraphFormat (ParagraphFormat nesnesi), paragraf düzeyindeki yerleşimi kontrol eder: Alignment, girintileri (LeftIndent, RightIndent, FirstLineIndent), boşlukları (SpaceBefore, SpaceAfter, LineSpacing, LineSpacingRule) ve sayfalama davranışını (KeepTogether, KeepWithNext, PageBreakBefore, WidowControl). ParagraphFormat.ClearFormatting() bunları varsayılanlara sıfırlar ve Paragraph.JoinRunsWithSameFormatting() aynı biçimlendirmeye sahip ardışık koşulları birleştirir — programatik düzenlemeler sonucunda bir paragrafta gereğinden fazla koşul kaldığında işe yarar.
Adım 4: Aralıkla Metin Bul ve Değiştir
İçerik taşıyan her düğüm — bir Document, Section, Paragraph veya Run — bir Range ortaya çıkar. Range.Text, o aralıktaki her şeyin düz metnini döndürür ve Range.Replace(pattern, replacement), sadece o aralığa sınırlı bir bul-ve-değiştir işlemi gerçekleştirir: bir Paragraph‘nin Range‘inde çağırarak yalnızca bir paragraftaki metni değiştirin veya Document.Range‘de tüm belgeyi arayın. Range.Delete(), aralığın içeriğini tamamen kaldırır.
Adım 5: Yorum Ekle
Bir Comment‘ı new Comment(doc, author, initial, dateTime) ile oluşturun, metnini SetText(text) ile ayarlayın, ardından diğer düğümler gibi ağaca ekleyin. Comment.AddReply(author, initial, dateTime, text), bir iş parçacıklı yanıt — kendisi bir Comment — ekler ve RemoveReply(reply) / RemoveAllReplies() yanıtları geri alır. Bir belgenin yorumları bir CommentCollection‘de toplanır.
Adım 6: Bir Paragrafı Liste Öğesine Dönüştür
Paragraph.ListFormat (ListFormat nesnesi), bir paragrafın bir listede yer alıp almadığını rapor eder ve kontrol eder: IsListItem ve ListLevelNumber mevcut durumunu rapor eder. ApplyBulletDefault(), paragrafı varsayılan bir madde işaretli öğeye, ApplyNumberDefault() ise varsayılan bir numaralı öğeye dönüştürür; ListIndent() / ListOutdent() iç içeleme seviyesini değiştirir ve RemoveNumbers() paragrafı tekrar düz bir paragraf haline getirir.
Yaygın Sorunlar ve Çözümler
Birini biçimlendirme Run’s yazı tipi, yanındaki metni değiştirmez. Bitişik metin farklıdır Run kendi Font örnek. Ya etkilenen her birini bulup biçimlendir Run, ya da biçimlendirmeyi şunun üzerine ayarla DocumentBuilder.Font yeni metin yazmadan önce.
Range.Replace niyetlenen alanın dışındaki metni değiştirir. Replace şunun üzerinde çağrıldı Document.Range daha dar bir düğüm aralığı yerine. Belirli bir … üzerinde çağırın Paragraph or Section metni değiştirilmeli.
Bir paragraf, madde işaretli bir liste öğesi gibi görünür ancak IsListItem is false. Madde işareti, gerçek liste biçimlendirmesi değil, yazılmış bir metindir. Şununla uygulayın ListFormat.ApplyBulletDefault() yerine.
Belge, çok daha fazla Run düğüm beklenenden daha fazla. Tekrarlanan küçük programatik düzenlemeler, yürütmeleri bölerek yeniden birleştirmez. Çağır Paragraph.JoinRunsWithSameFormatting() düzenlemeler bir toplu işleminden sonra.
Sıkça Sorulan Sorular
Run ile Paragraph arasındaki fark nedir?
Bir Run, bir karakter biçimlendirme kümesini paylaşan bir metin aralığıdır (Font). Bir Paragraph, bir veya daha fazla çalışma ve paragraf düzeyinde biçimlendirme (ParagraphFormat) içeren birleşik düğümdür.
Bir belgede ya da tek bir bölümdeki tüm metni nasıl okuyabilirim?
O düğümün Range özelliğinin Text özelliğini okuyun — document.Range.Text veya section.Range.Text.
Sadece bir paragraftaki metni, tüm belgeyi etkilemeden nasıl değiştiririm?
Document.Range üzerinde değil, o Paragraph‘ın Range‘sinde Replace(pattern, replacement)‘ı çağırın.
Mevcut bir yoruma nasıl yanıt veririm?
Orijinal Comment örneği üzerinde Comment.AddReply(author, initial, dateTime, text)‘ı çağırın.
Numaralı bir liste öğesini yeniden düz bir paragraf haline nasıl getiririm?
Bu paragrafın ListFormat‘ine RemoveNumbers() çağır.
