DocumentBuilder

DocumentBuilder class

Metin, resim ve diğer içerikleri eklemek, yazı tipini, paragrafı ve bölüm biçimlendirmesini belirtmek için yöntemler sağlar.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Belge Oluşturucu Genel Bakış belgeleme makalesi.

public class DocumentBuilder

yapıcılar

İsim	Tanım
DocumentBuilder()	Bu sınıfın yeni bir örneğini başlatır.
DocumentBuilder(Document)	Bu sınıfın yeni bir örneğini başlatır.
DocumentBuilder(DocumentBuilderOptions)	Bu sınıfın yeni bir örneğini başlatır.
DocumentBuilder(Document, DocumentBuilderOptions)	Bu sınıfın yeni bir örneğini başlatır.

Özellikleri

İsim	Tanım
Bold { get; set; }	Yazı tipi kalın olarak biçimlendirilmişse doğrudur.
CellFormat { get; }	Geçerli tablo hücresi biçimlendirme özelliklerini temsil eden bir nesne döndürür.
CurrentNode { get; }	Bu DocumentBuilder’da şu anda seçili olan düğümü alır.
CurrentParagraph { get; }	Bu bölümde şu anda seçili olan paragrafı alır`DocumentBuilder` .
CurrentSection { get; }	Bu bölümde şu anda seçili olan bölümü alır`DocumentBuilder` .
CurrentStory { get; }	Bu bölümde şu anda seçili olan hikayeyi alır`DocumentBuilder` .
CurrentStructuredDocumentTag { get; }	Bu belgede şu anda seçili olan yapılandırılmış belge etiketini alır`DocumentBuilder` .
Document { get; set; }	Alır veya ayarlar`Document` bu nesnenin bağlı olduğu nesne.
Font { get; }	Geçerli yazı tipi biçimlendirme özelliklerini temsil eden bir nesne döndürür.
IsAtEndOfParagraph { get; }	Geri Döndürür`doğru` imleç geçerli paragrafın sonunda ise.
IsAtEndOfStructuredDocumentTag { get; }	Geri Döndürürdoğru imleç yapılandırılmış bir belge etiketinin sonundaysa.
IsAtStartOfParagraph { get; }	Geri Döndürür`doğru`imleç geçerli paragrafın başındaysa (imleçten önce metin yoksa).
Italic { get; set; }	Yazı tipi italik olarak biçimlendirilmişse doğrudur.
ListFormat { get; }	Geçerli liste biçimlendirme özelliklerini temsil eden bir nesne döndürür.
PageSetup { get; }	Geçerli sayfa düzenini ve bölüm özelliklerini temsil eden bir nesne döndürür.
ParagraphFormat { get; }	Geçerli paragraf biçimlendirme özelliklerini temsil eden bir nesne döndürür.
RowFormat { get; }	Geçerli tablo satır biçimlendirme özelliklerini temsil eden bir nesne döndürür.
Underline { get; set; }	Geçerli yazı tipi için alt çizgi türünü alır/ayarlar.

yöntemler

İsim	Tanım
DeleteRow(int, int)	Bir tablodan bir satırı siler.
EndBookmark(string)	Belgedeki geçerli konumu yer imi sonu olarak işaretler.
EndColumnBookmark(string)	Belgedeki geçerli konumu bir sütun yer imi sonu olarak işaretler. Konum bir tablo hücresinde olmalıdır.
EndEditableRange()	Belgedeki geçerli konumu düzenlenebilir aralık sonu olarak işaretler.
EndEditableRange(EditableRangeStart)	Belgedeki geçerli konumu düzenlenebilir aralık sonu olarak işaretler.
EndRow()	Belgedeki bir tablo satırını sonlandırır.
EndTable()	Belgedeki bir tabloyu sonlandırır.
InsertBreak(BreakType)	Belgeye belirtilen türde bir kesme ekler.
InsertCell()	Belgeye bir tablo hücresi ekler.
InsertChart(ChartType, double, double)	Belgeye bir grafik nesnesi ekler ve belirtilen boyuta ölçekler.
InsertChart(ChartType, double, double, ChartStyle)	Belgeye bir grafik nesnesi ekler ve belirtilen boyuta ölçekler.
InsertChart(ChartType, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belgeye bir grafik nesnesi ekler ve belirtilen boyuta ölçekler.
InsertChart(ChartType, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType, ChartStyle)	Belgeye bir grafik nesnesi ekler ve belirtilen boyuta ölçekler.
InsertCheckBox(string, bool, int)	Geçerli konuma bir onay kutusu form alanı ekler.
InsertCheckBox(string, bool, bool, int)	Geçerli konuma bir onay kutusu form alanı ekler.
InsertComboBox(string, string[], int)	Geçerli konuma bir açılır kutu form alanı ekler.
InsertDocument(Document, ImportFormatMode)	İmleç konumuna bir belge ekler.
InsertDocument(Document, ImportFormatMode, ImportFormatOptions)	İmleç konumuna bir belge ekler.
InsertDocumentInline(Document, ImportFormatMode, ImportFormatOptions)	İmleç konumuna satır içi bir belge ekler.
InsertField(string)	Bir Word alanını bir belgeye ekler ve alan sonucunu günceller.
InsertField(FieldType, bool)	Bir Word alanını bir belgeye ekler ve isteğe bağlı olarak alan sonucunu günceller.
InsertField(string, string)	Alan sonucunu güncellemeden bir Word alanını belgeye ekler.
InsertFootnote(FootnoteType, string)	Belgeye dipnot veya sonnot ekler.
InsertFootnote(FootnoteType, string, string)	Belgeye dipnot veya sonnot ekler.
InsertForms2OleControl(Forms2OleControl)	Ekler`Forms2OleControl` nesneyi geçerli konuma taşı.
InsertGroupShape(params ShapeBase[])	Parametre olarak geçirilen şekilleri, geçerli konuma eklenen yeni bir GroupShape düğümüne gruplandırır.
InsertGroupShape(double, double, double, double, params ShapeBase[])	Belirtilen boyuttaki yeni bir GroupShape düğümüne parametre olarak geçirilen şekilleri gruplandırır ve belirtilen konuma eklenir.
InsertHorizontalRule()	Belgeye yatay bir kural şekli ekler.
InsertHtml(string)	Belgeye bir HTML dizesi ekler.
InsertHtml(string, bool)	Belgeye bir HTML dizesi ekler.
InsertHtml(string, HtmlInsertOptions)	Belgeye bir HTML dizesi ekler. Ek seçeneklerin belirtilmesine olanak tanır.
InsertHyperlink(string, string, bool)	Belgeye bir köprü metni ekler.
InsertImage(byte[])	Bir bayt dizisinden belgeye bir görüntü ekler. Görüntü satır içi ve %100 ölçekte eklenir.
InsertImage(Image)	.NET’ten bir görüntü eklerImage nesnesini belgeye ekleyin. Görüntü satır içi ve %100 ölçekte eklenir.
InsertImage(Stream)	Bir akıştan belgeye bir görüntü ekler. Görüntü satır içi ve %100 ölçekte eklenir.
InsertImage(string)	Bir dosyadan veya URL’den belgeye bir resim ekler. Resim satır içi ve %100 ölçekte eklenir.
InsertImage(byte[], double, double)	Bir bayt dizisinden belgeye satır içi bir resim ekler ve belirtilen boyuta ölçekler.
InsertImage(Image, double, double)	.NET’ten satır içi bir resim eklerImage nesnesini belgeye ekler ve belirtilen boyuta ölçekler.
InsertImage(Stream, double, double)	Bir akıştan belgeye satır içi bir resim ekler ve belirtilen boyuta ölçekler.
InsertImage(string, double, double)	Bir dosyadan veya URL’den belgeye satır içi bir resim ekler ve belirtilen boyuta ölçekler.
InsertImage(byte[], RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belirtilen konum ve boyutta bir bayt dizisinden bir resim ekler.
InsertImage(Image, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	.NET’ten bir görüntü eklerImage Belirtilen konum ve boyutta nesnesi.
InsertImage(Stream, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belirtilen konum ve boyutta bir akıştan bir görüntü ekler.
InsertImage(string, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belirtilen konuma ve boyuta bir dosyadan veya URL’den bir resim ekler.
InsertNode(Node)	İmlecin önüne bir düğüm ekler.
InsertOleObject(Stream, string, bool, Stream)	Bir akıştan gömülü bir OLE nesnesini belgeye ekler.
InsertOleObject(string, bool, bool, Stream)	Bir dosyadan belgeye gömülü veya bağlantılı bir OLE nesnesi ekler. Dosya uzantısını kullanarak OLE nesne türünü algılar.
InsertOleObject(string, string, bool, bool, Stream)	Bir dosyadan gömülü veya bağlantılı bir OLE nesnesini belgeye ekler. Belirtilen progID parametresini kullanarak OLE nesne türünü algılar.
InsertOleObjectAsIcon(Stream, string, string, string)	Bir akıştan belgeye simge olarak gömülü bir OLE nesnesi ekler. Simge dosyasını ve başlığı belirtmeye izin verir. Belirtilen progID parametresini kullanarak OLE nesne türünü algılar.
InsertOleObjectAsIcon(string, bool, string, string)	Belgeye simge olarak gömülü veya bağlantılı bir OLE nesnesi ekler. Simge dosyasını ve başlığı belirtmeye izin verir. Dosya uzantısını kullanarak OLE nesne türünü algılar.
InsertOleObjectAsIcon(string, string, bool, string, string)	Belgeye simge olarak gömülü veya bağlantılı bir OLE nesnesi ekler. Simge dosyasını ve başlığı belirtmeye izin verir. Belirtilen progID parametresini kullanarak OLE nesne türünü algılar.
InsertOnlineVideo(string, double, double)	Belgeye çevrimiçi bir video nesnesi ekler ve belirtilen boyuta ölçekler.
InsertOnlineVideo(string, string, byte[], double, double)	Belgeye çevrimiçi bir video nesnesi ekler ve belirtilen boyuta ölçekler.
InsertOnlineVideo(string, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belgeye çevrimiçi bir video nesnesi ekler ve belirtilen boyuta ölçekler.
InsertOnlineVideo(string, string, byte[], RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belgeye çevrimiçi bir video nesnesi ekler ve belirtilen boyuta ölçekler.
InsertParagraph()	Belgeye bir paragraf sonu ekler.
InsertShape(ShapeType, double, double)	Belirtilen tür ve boyutta satır içi şekil ekler.
InsertShape(ShapeType, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)	Belirtilen konum, boyut ve metin kaydırma türüyle serbest yüzen şekil ekler.
InsertSignatureLine(SignatureLineOptions)	Geçerli konuma bir imza satırı ekler.
InsertSignatureLine(SignatureLineOptions, RelativeHorizontalPosition, double, RelativeVerticalPosition, double, WrapType)	Belirtilen konuma bir imza satırı ekler.
InsertStructuredDocumentTag(SdtType)	Bir ekler`StructuredDocumentTag` belgeye.
InsertStyleSeparator()	Belgeye stil ayırıcı ekler.
InsertTableOfContents(string)	Belgeye bir TOC (içindekiler tablosu) alanı ekler.
InsertTextInput(string, TextFormFieldType, string, string, int)	Geçerli konuma bir metin formu alanı ekler.
MoveTo(Node)	İmleci satır içi bir düğüme veya bir paragrafın sonuna taşır.
MoveToBookmark(string)	İmleci bir yer imine taşır.
MoveToBookmark(string, bool, bool)	İmleci daha büyük bir hassasiyetle bir yer imine taşır.
MoveToCell(int, int, int, int)	İmleci geçerli bölümdeki bir tablo hücresine taşır.
MoveToDocumentEnd()	İmleci belgenin sonuna taşır.
MoveToDocumentStart()	İmleci belgenin başına taşır.
MoveToField(Field, bool)	İmleci belgedeki bir alana taşır.
MoveToHeaderFooter(HeaderFooterType)	İmleci geçerli bölümdeki bir üstbilgi veya altbilginin başına taşır.
MoveToMergeField(string)	İmleci belirtilen birleştirme alanının hemen ötesine taşır ve birleştirme alanını kaldırır.
MoveToMergeField(string, bool, bool)	Birleştirme alanını belirtilen birleştirme alanına taşır.
MoveToParagraph(int, int)	İmleci geçerli bölümdeki bir paragrafa taşır.
MoveToSection(int)	İmleci belirtilen bölümdeki gövdenin başına taşır.
MoveToStructuredDocumentTag(int, int)	İmleci geçerli bölümdeki yapılandırılmış bir belge etiketine taşır.
MoveToStructuredDocumentTag(StructuredDocumentTag, int)	İmleci yapılandırılmış belge etiketine taşır.
PopFont()	Yığında daha önce kaydedilmiş karakter biçimlendirmesini alır.
PushFont()	Mevcut karakter biçimlendirmesini yığına kaydeder.
StartBookmark(string)	Belgedeki geçerli konumu yer imi başlangıcı olarak işaretler.
StartColumnBookmark(string)	Belgedeki geçerli konumu bir sütun yer imi başlangıcı olarak işaretler. Konum bir tablo hücresinde olmalıdır.
StartEditableRange()	Belgedeki geçerli konumu düzenlenebilir bir aralık başlangıcı olarak işaretler.
StartTable()	Belgede bir tablo başlatır.
Write(string)	Belgeye geçerli ekleme konumuna bir dize ekler.
Writeln()	Belgeye bir paragraf sonu ekler.
Writeln(string)	Belgeye bir dize ve bir paragraf sonu ekler.

Notlar

DocumentBuilder bir yapı inşa etme sürecini kolaylaştırırDocument daha kolay. Document düğümlerden oluşan bir ağaçtan oluşan bileşik bir nesnedir ve content düğümlerini doğrudan ağaca eklemek mümkün olsa da, ağaç yapısının iyi anlaşılmasını gerektirir. DocumentBuilder karmaşık yapının bir “cephesi"dirDocument ve allows içeriği ve biçimlendirmeyi hızlı ve kolay bir şekilde eklemesine olanak tanır.

Bir tane oluşturDocumentBuilder ve onu bir şeyle ilişkilendirDocument.

TheDocumentBuilder çağırdığınızda metnin ekleneceği dahili bir imleç vardır Write ,Writeln ,InsertBreak ve diğer yöntemler. GezinebilirsinizDocumentBuilder Çeşitli MoveToXXX yöntemlerini kullanarak bir belgedeki farklı bir location konumuna imleç.

KullanınFont to belgedeki geçerli konumdan itibaren eklenen tüm metne uygulanacak karakter biçimlendirmesini belirten özellik.

KullanınParagraphFormat current ve eklenecek tüm paragraflar için paragraf biçimlendirmesini belirtmek için kullanılan özellik.

KullanınPageSetup current bölümü ve eklenecek tüm bölümler için sayfa ve bölüm özelliklerini belirtmek için kullanılan özellik.

KullanınCellFormat VeRowFormat özellikleri belirtmek için tablo hücreleri ve satırları için biçimlendirme özellikleri. KullanıcıInsertCell ve EndRow Bir tablo oluşturmanın yöntemleri.

DikkatFont ,ParagraphFormat VePageSetup Belgede farklı bir yere gittiğinizde biçimlendirme özelliklerinin yeni konumda kullanılabilmesini sağlamak için özellikler her zaman güncellenir.

Örnekler

Bir tablo oluşturmak için belge oluşturucunun nasıl kullanılacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Tabloyu başlatın, ardından ilk satırı iki hücreyle doldurun.
builder.StartTable();
builder.InsertCell();
builder.Write("Row 1, Cell 1.");
builder.InsertCell();
builder.Write("Row 1, Cell 2.");

// Yeni bir satır başlatmak için oluşturucunun "EndRow" metodunu çağırın.
builder.EndRow();
builder.InsertCell();
builder.Write("Row 2, Cell 1.");
builder.InsertCell();
builder.Write("Row 2, Cell 2.");
builder.EndTable();

doc.Save(ArtifactsDir + "DocumentBuilder.CreateTable.docx");

DocumentBuilder kullanılarak bir belgede üstbilgi ve altbilgilerin nasıl oluşturulacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// İlk, çift ve tek sayfalar için farklı üstbilgi ve altbilgi istediğimizi belirtin.
builder.PageSetup.DifferentFirstPageHeaderFooter = true;
builder.PageSetup.OddAndEvenPagesHeaderFooter = true;

// Başlıkları oluşturun, ardından her başlık türünü görüntülemek için belgeye üç sayfa ekleyin.
builder.MoveToHeaderFooter(HeaderFooterType.HeaderFirst);
builder.Write("Header for the first page");
builder.MoveToHeaderFooter(HeaderFooterType.HeaderEven);
builder.Write("Header for even pages");
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.Write("Header for all other pages");

builder.MoveToSection(0);
builder.Writeln("Page1");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page2");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page3");

doc.Save(ArtifactsDir + "DocumentBuilder.HeadersAndFooters.docx");

Özel kenarlıkları olan bir tablonun nasıl oluşturulacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartTable();

// Bir belge oluşturucu için tablo biçimlendirme seçeneklerini ayarlama
// bunları eklediğimiz her satıra ve hücreye uygulayacaktır.
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// Biçimlendirmeyi değiştirmek, bunu geçerli hücreye uygulayacaktır.
// ve sonrasında builder ile oluşturduğumuz yeni hücreler.
// Bu daha önce eklediğimiz hücreleri etkilemeyecektir.
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// Dikey metne uyacak şekilde satır yüksekliğini artırın.
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTable.docx");

Ayrıca bakınız

ad alanı Aspose.Words
toplantı Aspose.Words

DocumentBase Class DocumentBuilderOptions Class