Document

Document class

Bir Word belgesini temsil eder.

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

public class Document : DocumentBase

yapıcılar

İsimTanım
Document()Boş bir Word belgesi oluşturur.
Document(Stream)Bir akıştan mevcut bir belgeyi açar. Dosya biçimini otomatik olarak algılar.
Document(string)Bir dosyadan mevcut bir belgeyi açar. Dosya biçimini otomatik olarak algılar.
Document(Stream, LoadOptions)Bir akıştan mevcut bir belgeyi açar. Şifreleme şifresi gibi ek seçeneklerin belirtilmesine olanak tanır.
Document(string, LoadOptions)Bir dosyadan mevcut bir belgeyi açar. Şifreleme şifresi gibi ek seçeneklerin belirtilmesine olanak tanır.

Özellikleri

İsimTanım
AttachedTemplate { get; set; }Belgeye eklenen şablonun tam yolunu alır veya ayarlar.
AutomaticallyUpdateStyles { get; set; }Belgedeki stillerin, belge MS Word’de her açıldığında ekli şablondaki stilleriyle eşleşecek şekilde güncellenip güncellenmediğini belirten bir bayrak alır veya ayarlar.
BackgroundShape { get; set; }Belgenin arka plan şeklini alır veya ayarlar. Olabilirhükümsüz .
BuiltInDocumentProperties { get; }Belgenin tüm yerleşik belge özelliklerini temsil eden bir koleksiyon döndürür.
CompatibilityOptions { get; }Belge uyumluluk seçeneklerine (yani,Uyumluluk sekmesiSeçenekler Word’deki iletişim kutusu).
Compliance { get; }Yüklenen belge içeriğinden belirlenen OOXML uyumluluk sürümünü alır. Yalnızca OOXML belgeleri için anlamlıdır.
Count { get; }Bu düğümün doğrudan alt öğelerinin sayısını alır.
CustomDocumentProperties { get; }Belgenin tüm özel belge özelliklerini temsil eden bir koleksiyon döndürür.
CustomNodeId { get; set; }Özel düğüm tanımlayıcısını belirtir.
CustomXmlParts { get; set; }Özel XML Veri Depolama Parçalarının koleksiyonunu alır veya ayarlar.
DefaultTabStop { get; set; }Varsayılan sekme durakları arasındaki aralığı (puan cinsinden) alır veya ayarlar.
DigitalSignatures { get; }Bu belge için dijital imzaların toplanmasını ve doğrulama sonuçlarını alır.
override Document { get; }Bu örneği alır.
EndnoteOptions { get; }Bu belgedeki son notların numaralandırılmasını ve konumlandırılmasını kontrol eden seçenekler sunar.
FieldOptions { get; }Bir alırFieldOptions belgedeki alan işlemeyi kontrol etme seçeneklerini temsil eden nesne.
FirstChild { get; }Düğümün ilk çocuğunu alır.
FirstSection { get; }Belgedeki ilk bölümü alır.
FontInfos { get; }Bu belgede kullanılan yazı tiplerinin özelliklerine erişim sağlar.
FontSettings { get; set; }Belge yazı tipi ayarlarını alır veya ayarlar.
FootnoteOptions { get; }Bu belgedeki dipnotların numaralandırılmasını ve konumlandırılmasını kontrol eden seçenekler sunar.
Frameset { get; }Bir değeri döndürürFramesetörneğin bu belge bir çerçeve sayfasını temsil ediyorsa.
GlossaryDocument { get; set; }Bu belge veya şablon içindeki sözlük belgesini alır veya ayarlar. Sözlük belgesi, bir belgede tanımlanan Otomatik Metin, Otomatik Düzeltme ve Yapı Taşı girişleri için bir depolama ‘dir.
GrammarChecked { get; set; }İadelerdoğru belge dilbilgisi açısından kontrol edilmişse.
HasChildNodes { get; }İadelerdoğru bu düğümün herhangi bir alt düğümü varsa.
HasMacros { get; }İadelerdoğru belgede bir VBA projesi (makrolar) varsa.
HasRevisions { get; }İadelerdoğru belgede izlenen herhangi bir değişiklik varsa.
HyphenationOptions { get; }Belge tireleme seçeneklerine erişim sağlar.
IncludeTextboxesFootnotesEndnotesInStat { get; set; }Kelime sayısı istatistiklerine metin kutularının, dipnotların ve son notların dahil edilip edilmeyeceğini belirtir.
override IsComposite { get; }İadelerdoğru çünkü bu düğüm alt düğümlere sahip olabilir.
JustificationMode { get; set; }Bir belgenin karakter aralığı ayarını alır veya ayarlar.
LastChild { get; }Düğümün son çocuğunu alır.
LastSection { get; }Belgedeki son bölümü alır.
LayoutOptions { get; }Bir alırLayoutOptions bu belgenin düzen sürecini kontrol etme seçeneklerini temsil eden nesne.
Lists { get; }Belgede kullanılan liste formatına erişim sağlar.
MailMerge { get; }Bir değeri döndürürMailMerge belgenin adres-mektup birleştirme işlevini temsil eden nesne.
MailMergeSettings { get; set; }Bir belgeye ilişkin tüm adres-mektup birleştirme bilgilerini içeren nesneyi alır veya ayarlar.
NextSibling { get; }Bu düğümden hemen sonra gelen düğümü alır.
NodeChangingCallback { get; set; }Belgeye bir düğüm eklendiğinde veya kaldırıldığında çağrılır.
override NodeType { get; }İadelerDocument .
OriginalFileName { get; }Belgenin orijinal dosya adını alır.
OriginalLoadFormat { get; }Bu nesneye yüklenen orijinal belgenin biçimini alır.
PackageCustomParts { get; set; }“Bilinmeyen ilişkiler” kullanılarak OOXML paketine bağlanan özel parçaların (rastgele içerik) koleksiyonunu alır veya ayarlar.
PageColor { get; set; }Belgenin sayfa rengini alır veya ayarlar. Bu özellik, daha basit bir versiyonudurBackgroundShape .
PageCount { get; }En son sayfa düzeni işlemiyle hesaplanan belgedeki sayfa sayısını alır.
ParentNode { get; }Bu düğümün doğrudan ebeveynini alır.
PreviousSibling { get; }Bu düğümden hemen önceki düğümü alır.
ProtectionType { get; }Şu anda etkin olan belge koruma türünü alır.
Range { get; }Bir değeri döndürürRange Bu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
RemovePersonalInformation { get; set; }Belgeyi kaydettikten sonra Microsoft Word’ün yorumlardan, düzeltmelerden ve belge özelliklerinden tüm kullanıcı bilgilerini kaldıracağını belirten bir işaret alır veya ayarlar.
ResourceLoadingCallback { get; set; }Harici kaynakların nasıl yüklendiğini kontrol etmeye izin verir.
Revisions { get; }Bu belgede mevcut olan revizyonların (izlenen değişiklikler) bir koleksiyonunu alır.
RevisionsView { get; set; }Bir belgenin orijinal sürümüyle mi yoksa revize edilmiş sürümüyle mi çalışılacağını belirten bir değer alır veya ayarlar.
Sections { get; }Belgedeki tüm bölümleri temsil eden bir koleksiyon döndürür.
ShadeFormData { get; set; }Form alanlarında gri gölgelemenin açılıp açılmayacağını belirtir.
ShowGrammaticalErrors { get; set; }Bu belgede dilbilgisi hatalarının görüntülenip görüntülenmeyeceğini belirtir.
ShowSpellingErrors { get; set; }Bu belgede yazım hatalarının görüntülenip görüntülenmeyeceğini belirtir.
SpellingChecked { get; set; }İadelerdoğru belgenin yazım denetimi yapılmışsa.
Styles { get; }Belgede tanımlanan stillerin bir koleksiyonunu döndürür.
Theme { get; }AlırTheme bu belgeye ait nesne.
TrackRevisions { get; set; }Bu belge Microsoft Word’de düzenlenirken değişiklikler izleniyorsa doğrudur.
Variables { get; }Bir belgeye veya şablona eklenen değişkenlerin koleksiyonunu döndürür.
VbaProject { get; set; }Bir değeri alır veya ayarlarVbaProject .
VersionsCount { get; }DOC belgesinde saklanan belge sürümlerinin sayısını alır.
ViewOptions { get; }Belgenin Microsoft Word’de nasıl görüntüleneceğini kontrol etmek için seçenekler sunar.
WarningCallback { get; set; }Çeşitli belge işleme prosedürleri sırasında, verilerde veya formatta uygunluk kaybıyla sonuçlanabilecek bir sorun algılandığında çağrılır.
Watermark { get; }Belge filigranına erişim sağlar.
WebExtensionTaskPanes { get; }Görev bölmesi eklentilerinin listesini temsil eden bir koleksiyon döndürür.
WriteProtection { get; }Belge yazma koruması seçeneklerine erişim sağlar.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Ziyaretçi kabul eder.
AcceptAllRevisions()Belgede izlenen tüm değişiklikleri kabul eder.
AppendChild(Node)Belirtilen düğümü, bu düğüm için alt düğümler listesinin sonuna ekler.
AppendDocument(Document, ImportFormatMode)Belirtilen belgeyi bu belgenin sonuna ekler.
AppendDocument(Document, ImportFormatModeImportFormatOptions)Belirtilen belgeyi bu belgenin sonuna ekler.
Cleanup()Belgedeki kullanılmayan stilleri ve listeleri temizler.
Cleanup(CleanupOptions)Verilenlere bağlı olarak kullanılmayan stilleri ve listeleri belgeden temizler.CleanupOptions .
Clone()Derin bir kopyasını gerçekleştirir.Document .
Clone(bool)Düğümün bir kopyasını oluşturur.
Compare(Document, string, DateTime)Bu belgeyi, düzenleme ve biçim revizyonlarının sayısı olarak değişiklik üreten başka bir belgeyle karşılaştırırRevision .
Compare(Document, string, DateTime, CompareOptions)Bu belgeyi, bir dizi düzenleme ve biçim revizyonu şeklinde değişiklik üreten başka bir belgeyle karşılaştırırRevision . Karşılaştırma seçeneklerini belirtmeye olanak sağlar.CompareOptions .
CopyStylesFromTemplate(Document)Stilleri belirtilen şablondan bir belgeye kopyalar.
CopyStylesFromTemplate(string)Stilleri belirtilen şablondan bir belgeye kopyalar.
CreateNavigator()Düğümlerin arasında geçiş yapmak ve düğümleri okumak için kullanılabilecek gezgini oluşturur.
EnsureMinimum()Belgede bölüm yoksa, tek paragraflı bir bölüm oluşturur.
ExpandTableStylesToDirectFormatting()Tablo stillerinde belirtilen biçimlendirmeyi, belgedeki tablolardaki doğrudan biçimlendirmeye dönüştürür.
ExtractPages(int, int)Şunu döndürür:Document belirtilen sayfa aralığını temsil eden nesne.
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.
GetPageInfo(int)Yazdırma veya işleme için faydalı olabilecek sayfa boyutunu, yönünü ve bir sayfa hakkındaki diğer bilgileri alır.
override GetText()Bu düğümün ve tüm alt öğelerinin metnini alır.
ImportNode(Node, bool)Başka bir belgedeki bir düğümü geçerli belgeye aktarır.
ImportNode(Node, bool, ImportFormatMode)Biçimlendirmeyi kontrol etme seçeneğiyle birlikte başka bir belgedeki bir düğümü geçerli belgeye aktarır.
IndexOf(Node)Alt düğüm dizisinde belirtilen alt düğümün dizinini döndürür.
InsertAfter(NodeNode)Belirtilen düğümü, belirtilen referans düğümünün hemen sonrasına ekler.
InsertBefore(NodeNode)Belirtilen düğümü, belirtilen referans düğümünün hemen öncesine ekler.
JoinRunsWithSameFormatting()Birleştirmeler belgenin tüm paragraflarında aynı formatta çalışır.
NextPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre sonraki düğümü alır.
NormalizeFieldTypes()Alan türü değerlerini değiştirirFieldType ile ilgiliFieldStart ,FieldSeparator ,FieldEnd alan kodlarında yer alan alan türlerine karşılık gelecek şekilde tüm belgede.
PrependChild(Node)Belirtilen düğümü, bu düğüm için alt düğümler listesinin başına ekler.
PreviousPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre önceki düğümü alır.
Print()Belgenin tamamını varsayılan yazıcıya yazdırır.
Print(PrinterSettings)Belgeyi belirtilen yazıcı ayarlarına göre standart (Kullanıcı Arayüzü yok) yazdırma denetleyicisini kullanarak yazdırır.
Print(string)Standart (Kullanıcı Arayüzü olmayan) yazdırma denetleyicisini kullanarak belgenin tamamını belirtilen yazıcıya, yazdırın.
Print(PrinterSettings, string)Belgeyi belirtilen yazıcı ayarlarına göre standart (Kullanıcı Arayüzü yok) yazdırma denetleyicisini ve belge adını kullanarak yazdırır.
Protect(ProtectionType)Mevcut şifreyi değiştirmeden belgeyi değişikliklere karşı korur veya rastgele bir şifre atar.
Protect(ProtectionType, string)Belgeyi değişikliklere karşı korur ve isteğe bağlı olarak bir koruma parolası ayarlar.
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.
RemoveExternalSchemaReferences()Bu belgeden harici XML şeması referanslarını kaldırır.
RemoveMacros()Tüm makroların (VBA projesinin) yanı sıra araç çubuklarını ve komut özelleştirmelerini belgeden kaldırır.
RemoveSmartTags()Tümünü kaldırırSmartTagGeçerli düğümün alt düğümleri.
RenderToScale(int, Graphics, float, float, float)Bir belge sayfasını birGraphics belirtilen ölçeğe itiraz.
RenderToSize(int, Graphics, float, float, float, float)Bir belge sayfasını birGraphics belirtilen boyuta nesne.
Save(string)Belgeyi bir dosyaya kaydeder. Uzantıdan kaydetme biçimini otomatik olarak belirler.
Save(Stream, SaveFormat)Belirtilen formatı kullanarak belgeyi bir akışa kaydeder.
Save(Stream, SaveOptions)Belirtilen kaydetme seçeneklerini kullanarak belgeyi bir akışa kaydeder.
Save(string, SaveFormat)Belgeyi belirtilen formatta bir dosyaya kaydeder.
Save(string, SaveOptions)Belirtilen kaydetme seçeneklerini kullanarak belgeyi bir dosyaya kaydeder.
Save(HttpResponse, string, ContentDispositionSaveOptions)Belgeyi istemci tarayıcısına gönderir.
SelectNodes(string)XPath ifadesiyle eşleşen düğümlerin listesini seçer.
SelectSingleNode(string)İlkini seçerNode XPath ifadesiyle eşleşen.
StartTrackRevisions(string)Belgede yaptığınız diğer tüm değişiklikleri otomatik olarak revizyon değişiklikleri olarak işaretlemeye başlar.
StartTrackRevisions(string, DateTime)Belgede yaptığınız diğer tüm değişiklikleri otomatik olarak revizyon değişiklikleri olarak işaretlemeye başlar.
StopTrackRevisions()Belge değişikliklerinin otomatik olarak revizyon olarak işaretlenmesini durdurur.
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.
UnlinkFields()Tüm belgedeki alanların bağlantısını kaldırır.
Unprotect()Paroladan bağımsız olarak belgedeki korumayı kaldırır.
Unprotect(string)Doğru parola belirtilirse belgedeki korumayı kaldırır.
UpdateFields()Belgenin tamamındaki alanların değerlerini günceller.
UpdateListLabels()Belgedeki tüm liste öğeleri için liste etiketlerini günceller.
UpdatePageLayout()Belgenin sayfa düzenini yeniden oluşturur.
UpdateThumbnail()GüncellemelerThumbnail varsayılan seçenekleri kullanarak belgenin.
UpdateThumbnail(ThumbnailGeneratingOptions)GüncellemelerThumbnail belirtilen seçeneklere göre belgenin.
UpdateWordCount()Belgenin kelime sayısı özelliklerini günceller.
UpdateWordCount(bool)Belgenin kelime sayısı özelliklerini günceller, isteğe bağlı olarak güncellerLines özellik.

Notlar

Document Aspose.Words kütüphanesindeki merkezi bir nesnedir.

Mevcut bir belgeyi herhangi bir yere yüklemek içinLoadFormat formatlarından birine bir dosya name veya bir akış iletin.Documentinşaatçılar. Boş bir belge oluşturmak için the yapıcısını parametreler olmadan çağırın.

Belgeyi the ‘den herhangi birine kaydetmek için Save yöntemi aşırı yüklemelerinden birini kullanın.SaveFormat formatlar.

Belge sayfalarını doğrudan bir sayfaya çizmek içinGrafik nesne kullanımı RenderToScale veyaRenderToSize yöntem.

Belgeyi yazdırmak için aşağıdakilerden birini kullanın:Print yöntemler.

MailMerge Aspose.Words’ün Microsoft Word’de tasarlanmış raporların çeşitli veri kaynaklarından gelen verilerle hızlı ve kolay bir şekilde doldurulmasına olanak sağlayan raporlama motorudur. Veriler bir DataSet, DataTable, DataView, IDataReader veya bir değer dizisinden olabilir. Posta birleştirme veri kaynağında bulunan kayıtları inceleyecek ve bunları gerektiği gibi büyüterek belgedeki adres-mektup birleştirme alanlarına ekleyecektir.

Document gibi belge genelindeki bilgileri saklarStyles , BuiltInDocumentProperties ,CustomDocumentProperties listeler ve makrolar. Bu nesnelerin çoğuna, ilgili nesnenin ilgili özellikleri aracılığıyla erişilebilir.Document.

Document belgenin tüm diğer düğümlerini içeren bir ağacın kök düğümüdür. Ağaç bir Bileşik tasarım desenidir ve birçok yönden XmlDocument’e benzer. Belgenin içeriği program aracılığıyla serbestçe değiştirilebilir:

  • Belgenin düğümlerine, örneğin yazılan koleksiyonlar aracılığıyla erişilebilir.Sections , ParagraphCollection vesaire.
  • Belgenin düğümleri, kullanılarak düğüm türlerine göre seçilebilirGetChildNodes veya bir XPath sorgusu kullanarakSelectNodes veyaSelectSingleNode.
  • İçerik düğümleri, kullanılarak belgenin herhangi bir yerinden eklenebilir veya kaldırılabilirInsertBefore ,InsertAfter , RemoveChild ve temel sınıf tarafından sağlanan other yöntemleriCompositeNode.
  • Her düğümün biçimlendirme öznitelikleri, o düğümün özellikleri aracılığıyla değiştirilebilir.

Kullanmayı düşününDocumentBuilderbu, programlı olarak oluşturma veya belge ağacını doldurma görevini basitleştirir.

Document yalnızca içerebilirSection nesneler.

Microsoft Word’de geçerli bir belgenin en az bir bölümü olması gerekir.

Örnekler

DataTable’daki verilerle adres-mektup birleştirmenin nasıl yürütüleceğini gösterir.

public void ExecuteDataTable()
{
    DataTable table = new DataTable("Test");
    table.Columns.Add("CustomerName");
    table.Columns.Add("Address");
    table.Rows.Add(new object[] { "Thomas Hardy", "120 Hanover Sq., London" });
    table.Rows.Add(new object[] { "Paolo Accorti", "Via Monte Bianco 34, Torino" });

    // Aşağıda, adres-mektup birleştirme için veri kaynağı olarak DataTable'ı kullanmanın iki yolu verilmiştir.
    // 1 - Tablodaki her satır için bir çıktı adres-mektup birleştirme belgesi oluşturmak amacıyla adres-mektup birleştirme için tablonun tamamını kullanın:
    Document doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.WholeTable.docx");

    // 2 - Bir çıktı adres-mektup birleştirme belgesi oluşturmak için tablonun bir satırını kullanın:
    doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table.Rows[1]);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.OneRow.docx");
}

/// <summary>
/// Adres-mektup birleştirme kaynak belgesi oluşturur.
/// </summary>
private static Document CreateSourceDocExecuteDataTable()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.InsertField(" MERGEFIELD CustomerName ");
    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD Address ");

    return doc;
}

Ayrıca bakınız