Section

Section class

Bir belgedeki tek bir bölümü temsil eder.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Bölümlerle Çalışmak dokümantasyon makalesi.

public sealed class Section : CompositeNode

yapıcılar

İsimTanım
Section(DocumentBase)Bölüm sınıfının yeni bir örneğini başlatır.

Özellikleri

İsimTanım
Body { get; }Şunu döndürür:Body bölümün alt düğümü.
Count { get; }Bu düğümün doğrudan alt öğelerinin sayısını alır.
CustomNodeId { get; set; }Özel düğüm tanımlayıcısını belirtir.
virtual Document { get; }Bu düğümün ait olduğu belgeyi alır.
FirstChild { get; }Düğümün ilk çocuğunu alır.
HasChildNodes { get; }İadelerdoğru bu düğümün herhangi bir alt düğümü varsa.
HeadersFooters { get; }Bölümün üst bilgi ve alt bilgi düğümlerine erişim sağlar.
override IsComposite { get; }İadelerdoğru çünkü bu düğüm alt düğümlere sahip olabilir.
LastChild { get; }Düğümün son çocuğunu alır.
NextSibling { get; }Bu düğümden hemen sonra gelen düğümü alır.
override NodeType { get; }İadelerSection .
PageSetup { get; }Sayfa düzenini ve bölüm özelliklerini temsil eden bir nesneyi döndürür.
ParentNode { get; }Bu düğümün doğrudan ebeveynini alır.
PreviousSibling { get; }Bu düğümden hemen önceki düğümü alır.
ProtectedForForms { get; set; }Bölüm formlar için korunuyorsa doğrudur. Bir bölüm formlar için korunduğunda, kullanıcıları yalnızca Microsoft Word’deki form alanlarındaki metni seçebilir ve değiştirebilir.
Range { get; }Bir değeri döndürürRange Bu düğümde bulunan bir belgenin bölümünü temsil eden nesne.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Ziyaretçi kabul eder.
AppendChild(Node)Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler.
AppendContent(Section)Kaynak bölümünün içeriğinin bir kopyasını bu bölümün sonuna ekler.
ClearContent()Bölümü temizler.
ClearHeadersFooters()Bu bölümün üstbilgilerini ve altbilgilerini temizler.
Clone()Bu bölümün bir kopyasını oluşturur.
Clone(bool)Düğümün bir kopyasını oluşturur.
CreateNavigator()Düğümlerin arasında geçiş yapmak ve düğümleri okumak için kullanılabilecek gezgini oluşturur.
DeleteHeaderFooterShapes()Bu bölümün üst bilgilerinden ve alt bilgilerinden tüm şekilleri (çizim nesneleri) siler.
EnsureMinimum()Bölümün sahip olmasını sağlarBody biriyleParagraph .
GetAncestor(NodeType)Belirtilenin ilk atayı alırNodeType .
GetAncestor(Type)Belirtilen nesne türünün ilk atayı alır.
GetChild(NodeType, int, bool)Belirtilen türle eşleşen N’inci alt düğümü döndürür.
GetChildNodes(NodeType, bool)Belirtilen türle eşleşen alt düğümlerin canlı bir koleksiyonunu döndürür.
GetEnumerator()Bu düğümün alt düğümleri üzerindeki her stil yinelemesi için destek sağlar.
override GetText()Bu düğümün ve tüm alt öğelerinin metnini alır.
IndexOf(Node)Alt düğüm dizisinde belirtilen alt düğümün dizinini döndürür.
InsertAfter(Node, Node)Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler.
InsertBefore(Node, Node)Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine ekler.
NextPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre sonraki düğümü alır.
PrependChild(Node)Belirtilen düğümü, bu düğüm için alt düğümler listesinin başına ekler.
PrependContent(Section)Kaynak bölümünün içeriğinin bir kopyasını bu bölümün başına ekler.
PreviousPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre önceki düğümü alır.
Remove()Kendini üst öğeden kaldırır.
RemoveAllChildren()Geçerli düğümün tüm alt düğümlerini kaldırır.
RemoveChild(Node)Belirtilen alt düğümü kaldırır.
RemoveSmartTags()Tümünü kaldırırSmartTagGeçerli düğümün alt düğümleri.
SelectNodes(string)XPath ifadesiyle eşleşen düğümlerin listesini seçer.
SelectSingleNode(string)İlkini seçerNode XPath ifadesiyle eşleşen.
ToString(SaveFormat)Düğümün içeriğini belirtilen formatta bir dizeye aktarır.
ToString(SaveOptions)Belirtilen kaydetme seçeneklerini kullanarak düğümün içeriğini bir dizeye aktarır.

Notlar

Section bir tane olabilirBody ve maksimum birHeaderFooter her birinden HeaderFooterType .Body VeHeaderFooter nodes içeride herhangi bir sırada olabilirSection.

Minimum geçerli bölümün olması gerekirBody biriyleParagraph.

Her bölümün sayfa boyutunu, yönünü, kenar boşluklarını vb. belirten kendi özellikleri vardır.

kullanarak bir bölümün kopyasını oluşturabilirsiniz.Clone. Kopya aynı veya farklı belgeye eklenebilir.

Bölüm sonu ve bölüm özellikleri de dahil olmak üzere bir bölümün tamamını eklemek, eklemek veya kaldırmak için aşağıdaki yöntemleri kullanın:Sections nesne.

Break bölümü ve bölüm özellikleri hariç, yalnızca bölümün içeriğini kopyalamak ve eklemek için şunu kullanın:AppendContent VePrependContent yöntemler.

Örnekler

Aspose.Words belgesinin elle nasıl oluşturulacağını gösterir.

Document doc = new Document();

// Boş bir belge bir bölüm, bir gövde ve bir paragraftan oluşur.
// Tüm bu düğümleri kaldırmak için "RemoveAllChildren" yöntemini çağırın,
// ve çocuğu olmayan bir belge düğümü elde ederiz.
doc.RemoveAllChildren();

// Bu belgede artık içerik ekleyebileceğimiz bileşik alt düğüm yok.
// Eğer onu düzenlemek istiyorsak, düğüm koleksiyonunu yeniden doldurmamız gerekecek.
// Öncelikle yeni bir bölüm oluşturun ve ardından bunu alt öğe olarak kök belge düğümüne ekleyin.
Section section = new Section(doc);
doc.AppendChild(section);

// Bölüm için bazı sayfa yapısı özelliklerini ayarlayın.
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// Bir bölümün tüm içeriğini içerecek ve görüntüleyecek bir gövdeye ihtiyacı vardır
// bölümün üstbilgisi ve altbilgisi arasındaki sayfada.
Body body = new Body(doc);
section.AppendChild(body);

// Bir paragraf oluşturun, bazı biçimlendirme özelliklerini ayarlayın ve ardından onu alt öğe olarak gövdeye ekleyin.
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// Son olarak belgeyi yapmak için biraz içerik ekleyin. Bir koşu oluşturun,
// görünüşünü ve içeriğini ayarlayın ve ardından onu alt öğe olarak paragrafa ekleyin.
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);

Assert.AreEqual("Hello World!", doc.GetText().Trim());

doc.Save(ArtifactsDir + "Section.CreateManually.docx");

Ayrıca bakınız

SaveFormat Enum SectionCollection Class