Document
Document class
Bir Word belgesini temsil eder.
Daha fazla bilgi edinmek için şu adresi ziyaret edin:Belgeyle Çalışma belgeleme makalesi.
public class Document : DocumentBase
yapıcılar
| İsim | Tanı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 parolası gibi ek seçeneklerin belirtilmesine olanak tanır. |
| Document(string, LoadOptions) | Bir dosyadan mevcut bir belgeyi açar. Şifreleme parolası gibi ek seçeneklerin belirtilmesine olanak tanır. |
Özellikleri
| İsim | Tanı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 stillerle eşleşecek şekilde güncellenip güncellenmeyeceğini belirten bir bayrak alır veya ayarlar. |
| BackgroundShape { get; set; } | Belgenin arka plan şeklini alır veya ayarlar.hükümsüz . |
| Bibliography { get; } | Şunu alır:Bibliographybelgede mevcut kaynakların listesini temsil eden nesne. |
| BuiltInDocumentProperties { get; } | Belgenin tüm yerleşik belge özelliklerini temsil eden bir koleksiyon döndürür. |
| CompatibilityOptions { get; } | Belge uyumluluk seçeneklerine erişim sağlar (yani, belgeye girilen kullanıcı tercihleri)Uyumluluk sekmesiSeçeneklerWord’de 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 mantıklıdır. |
| Count { get; } | Bu düğümün hemen alt düğümlerinin 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ı koleksiyonunu alır veya ayarlar. |
| DefaultTabStop { get; set; } | Varsayılan sekme durakları arasındaki aralığı (nokta cinsinden) alır veya ayarlar. |
| DigitalSignatures { get; } | Bu belge için dijital imzaların koleksiyonunu ve bunların doğrulama sonuçlarını alır. |
| override Document { get; } | Bu örneği alır. |
| EndnoteOptions { get; } | Bu belgedeki dipnotların numaralandırılmasını ve konumlandırılmasını kontrol eden seçenekler sağlar. |
| FieldOptions { get; } | Bir tane 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 sağlar. |
| FootnoteSeparators { get; } | Belgede tanımlanan dipnot/sonnot ayırıcılarına erişim sağlar. |
| Frameset { get; } | BirFrameset ö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; } | Geri Döndürürdoğru belgenin dil bilgisi açısından kontrol edilip edilmediği. |
| HasChildNodes { get; } | Geri Döndürürdoğru eğer bu düğümün herhangi bir alt düğümü varsa. |
| HasMacros { get; } | Geri Döndürürdoğru eğer belgenin bir VBA projesi varsa (makrolar). |
| HasRevisions { get; } | Geri Döndürürdoğru belgede izlenen değişiklikler varsa. |
| HyphenationOptions { get; } | Belge tireleme seçeneklerine erişim sağlar. |
| IncludeTextboxesFootnotesEndnotesInStat { get; set; } | Kelime sayısı istatistiklerine metin kutuları, dipnotlar ve son notların dahil edilip edilmeyeceğini belirtir. |
| override IsComposite { get; } | Geri Döndürürdoğru çünkü bu düğümün alt düğümleri 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 tane alırLayoutOptions Bu belgenin düzen sürecini kontrol etmek için seçenekleri temsil eden nesne. |
| Lists { get; } | Belgede kullanılan liste biçimlendirmesine erişim sağlar. |
| MailMerge { get; } | BirMailMerge belge için posta birleştirme işlevini temsil eden nesne. |
| MailMergeSettings { get; set; } | Bir belgenin tüm posta birleştirme bilgilerini içeren nesneyi alır veya ayarlar. |
| NextSibling { get; } | Bu düğümü hemen takip eden 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; } | Geri DöndürürDocument . |
| 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ğlı olan özel parçaların (keyfi içerik) koleksiyonunu alır veya ayarlar. |
| PageColor { get; set; } | Belgenin sayfa rengini alır veya ayarlar. Bu özellik, daha basit bir sürümüdürBackgroundShape . |
| PageCount { get; } | En son sayfa düzeni işlemi tarafından hesaplanan belgedeki sayfa sayısını alır. |
| ParentNode { get; } | Bu düğümün en yakın üst düğümünü 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. |
| PunctuationKerning { get; set; } | Harfin hem Latin metinlerine hem de noktalama işaretlerine uygulanıp uygulanmayacağını belirtir. |
| Range { get; } | BirRangebu düğümde bulunan bir belgenin bölümünü temsil eden nesne. |
| RemovePersonalInformation { get; set; } | Microsoft Word’ün belgeyi kaydederken tüm kullanıcı bilgilerini yorumlardan, düzeltmelerden ve belge özelliklerinden kaldıracağını belirten bir bayrak alır veya ayarlar. |
| ResourceLoadingCallback { get; set; } | Harici kaynakların nasıl yükleneceğini kontrol etmenizi sağlar. |
| Revisions { get; } | Bu belgede bulunan revizyonların (izlenen değişikliklerin) bir koleksiyonunu alır. |
| RevisionsView { get; set; } | Bir belgenin orijinal veya revize edilmiş sürümüyle çalışılıp çalışılmayacağı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ölgelendirmenin açılıp açılmayacağını belirtir. |
| ShowGrammaticalErrors { get; set; } | Bu belgede dilbilgisi hatalarının gösterilip gösterilmeyeceğini belirtir. |
| ShowSpellingErrors { get; set; } | Bu belgede yazım hatalarının gösterilip gösterilmeyeceğini belirtir. |
| SpellingChecked { get; set; } | Geri Döndürürdoğru belgenin yazım denetimi yapılmışsa. |
| Styles { get; } | Belgede tanımlanan stil koleksiyonunu döndürür. |
| Theme { get; } | Şunu alır:Theme bu belge için nesne. |
| TrackRevisions { get; set; } | Bu belge Microsoft Word’de düzenlendiğinde değişiklikler izleniyorsa doğrudur. |
| Variables { get; } | Bir belgeye veya şablona eklenen değişken 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 sağlar. |
| WarningCallback { get; set; } | Çeşitli belge işleme prosedürleri sırasında, veri veya biçimlendirme sadakat kaybına neden olabilecek 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 bir listesini temsil eden bir koleksiyon döndürür. |
| WriteProtection { get; } | Belge yazma koruması seçeneklerine erişim sağlar. |
yöntemler
| İsim | Tanım |
|---|---|
| override Accept(DocumentVisitor) | Bir ziyaretçiyi kabul eder. |
| AcceptAllRevisions() | Belgedeki tüm izlenen değişiklikleri kabul eder. |
| override AcceptEnd(DocumentVisitor) | Belgenin sonunu ziyaret eden bir ziyaretçiyi kabul eder. |
| override AcceptStart(DocumentVisitor) | Belgenin başlangıcını ziyaret eden bir ziyaretçiyi kabul eder. |
| AppendChild<T>(T) | 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, ImportFormatMode, ImportFormatOptions) | Belirtilen belgeyi bu belgenin sonuna ekler. |
| Cleanup() | Belgeden kullanılmayan stilleri ve listeleri temizler. |
| Cleanup(CleanupOptions) | Belirtilenlere bağlı olarak kullanılmayan stilleri ve listeleri belgeden temizlerCleanupOptions . |
| Clone() | Derin bir kopyasını gerçekleştirirDocument . |
| 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 başka bir belgeyle karşılaştırır ve bir dizi düzenleme ve biçim revizyonu olarak değişiklikler üretirRevision . Karşılaştırma seçeneklerini belirtmeye olanak tanırCompareOptions . |
| CopyStylesFromTemplate(Document) | Belirtilen şablondan bir belgeye stilleri kopyalar. |
| CopyStylesFromTemplate(string) | Belirtilen şablondan bir belgeye stilleri kopyalar. |
| CreateNavigator() | Düğümleri gezmek ve okumak için kullanılabilen gezgini oluşturur. |
| EnsureMinimum() | Belgede bölüm yoksa, bir paragraf içeren bir bölüm oluşturur. |
| ExpandTableStylesToDirectFormatting() | Tablo stillerinde belirtilen biçimlendirmeyi, belgedeki tablolarda 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 atasını alırNodeType . |
| GetAncestor(Type) | Belirtilen nesne türünün ilk atasını 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 yararlı olabilecek bir sayfa hakkında sayfa boyutu, yönlendirme ve diğer bilgileri alır. |
| override GetText() | Bu düğümün ve tüm alt düğümlerinin metnini alır. |
| ImportNode(Node, bool) | Başka bir belgeden bir düğümü geçerli belgeye aktarır. |
| ImportNode(Node, bool, ImportFormatMode) | Biçimlendirmeyi kontrol etme seçeneğiyle başka bir belgeden geçerli belgeye bir düğüm aktarır. |
| IndexOf(Node) | Alt düğüm dizisindeki belirtilen alt düğümün dizinini döndürür. |
| InsertAfter<T>(T, Node) | Belirtilen düğümü belirtilen referans düğümünden hemen sonra ekler. |
| InsertBefore<T>(T, Node) | Belirtilen düğümü belirtilen referans düğümünden hemen önce ekler. |
| JoinRunsWithSameFormatting() | Belgenin tüm paragraflarında aynı biçimlendirmeyle çalışmaları birleştirir. |
| NextPreOrder(Node) | Ön sipariş ağacı geçiş algoritmasına göre bir sonraki düğümü alır. |
| NormalizeFieldTypes() | Alan türü değerlerini değiştirirFieldType ile ilgiliFieldStart ,FieldSeparator ,FieldEnd tüm belgede, alan kodlarında bulunan alan türlerine karşılık gelecek şekilde. |
| PrependChild<T>(T) | Belirtilen düğümü bu düğüm için alt düğümler listesinin başına ekler. |
| PreviousPreOrder(Node) | Ön sipariş ağacı geçiş algoritmasına göre önceki düğümü alır. |
| Print() | Tüm belgeyi varsayılan yazıcıya yazdırır. |
| Print(PrinterSettings) | Belgeyi belirtilen yazıcı ayarlarına göre yazdırır, standart (Kullanıcı Arayüzü yok) yazdırma denetleyicisini kullanarak. |
| Print(string) | Tüm belgeyi belirtilen yazıcıya yazdırın, standart (Kullanıcı Arayüzü yok) yazdırma denetleyicisini kullanarak. |
| Print(PrinterSettings, string) | Standart (Kullanıcı Arayüzü yok) yazdırma denetleyicisini ve bir belge adını kullanarak, belirtilen yazıcı ayarlarına göre belgeyi yazdırır. |
| Protect(ProtectionType) | Mevcut parolayı değiştirmeden belgeyi değişikliklere karşı korur veya rastgele bir parola atar. |
| Protect(ProtectionType, string) | Belgeyi değişikliklere karşı korur ve isteğe bağlı olarak bir koruma parolası ayarlar. |
| Remove() | Kendini ana öğeden kaldırır. |
| RemoveAllChildren() | Geçerli düğümün tüm alt düğümlerini kaldırır. |
| RemoveBlankPages() | Belgeden boş sayfaları kaldırır. |
| RemoveChild<T>(T) | Belirtilen alt düğümü kaldırır. |
| RemoveExternalSchemaReferences() | Bu belgeden harici XML şema referanslarını kaldırır. |
| RemoveMacros() | Belgeden tüm makroları (VBA projesi) ve araç çubuklarını ve komut özelleştirmelerini kaldırır. |
| RemoveSmartTags() | Tümünü kaldırırSmartTag geçerli düğümün alt düğümleri. |
| RenderToScale(int, Graphics, float, float, float) | Bir belge sayfasını birGraphics belirli bir ölçeğe göre nesne. |
| RenderToSize(int, Graphics, float, float, float, float) | Bir belge sayfasını birGraphics nesneyi belirtilen bir boyuta taşı. |
| Save(string) | Belgeyi bir dosyaya kaydeder. Uzantıdan kaydetme biçimini otomatik olarak belirler. |
| Save(Stream, SaveFormat) | Belgeyi belirtilen biçimi kullanarak bir akışa kaydeder. |
| Save(Stream, SaveOptions) | Belirtilen kaydetme seçeneklerini kullanarak belgeyi bir akışa kaydeder. |
| Save(string, SaveFormat) | Belgeyi belirtilen biçimde bir dosyaya kaydeder. |
| Save(string, SaveOptions) | Belirtilen kaydetme seçeneklerini kullanarak belgeyi bir dosyaya kaydeder. |
| Save(HttpResponse, string, ContentDisposition, SaveOptions) | Belgeyi istemci tarayıcısına gönderir. |
| SelectNodes(string) | XPath ifadesiyle eşleşen düğümlerin bir listesini seçer. |
| SelectSingleNode(string) | İlkini seçerNode XPath ifadesiyle eşleşen. |
| StartTrackRevisions(string) | Belgede yaptığınız tüm sonraki değişiklikleri programatik olarak revizyon değişiklikleri olarak otomatik olarak işaretlemeye başlar. |
| StartTrackRevisions(string, DateTime) | Belgede yaptığınız tüm sonraki değişiklikleri programatik olarak revizyon değişiklikleri olarak otomatik olarak işaretlemeye başlar. |
| StopTrackRevisions() | Belge değişikliklerinin revizyon olarak otomatik olarak işaretlenmesini durdurur. |
| ToString(SaveFormat) | Düğümün içeriğini belirtilen biçimde 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 belgenin korumasını kaldırır. |
| Unprotect(string) | Doğru bir parola belirtilirse belgeden korumayı kaldırır. |
| UpdateActualReferenceMarks() | GüncellerActualReferenceMark belgedeki tüm dipnot ve sonnotların mülkiyeti. |
| UpdateFields() | Tüm belgedeki alanların değerlerini günceller. |
| UpdateListLabels() | Belgedeki tüm liste öğelerinin 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 mülk. |
Notlar
TheDocument Aspose.Words kütüphanesinin merkezi nesnesidir.
Mevcut bir belgeyi herhangi birine yüklemek içinLoadFormat biçimleri, dosya adı veya bir akışı bunlardan birine geçirinDocument yapıcılar. Boş bir belge oluşturmak için, parametresiz the yapıcısını çağırın.
Belgeyi herhangi bir dosyasına kaydetmek için Kaydet yöntemi aşırı yüklemelerinden birini kullanınSaveFormat biçimleri.
Belge sayfalarını doğrudan bir belgeye çizmek içinGrafikler nesne use RenderToScale veyaRenderToSize yöntem.
Belgeyi yazdırmak için aşağıdakilerden birini kullanın:Print Yöntemler.
MailMergeMicrosoft Word’de tasarlanmış raporları çeşitli veri kaynaklarından gelen verilerle hızlı ve kolay bir şekilde doldurmanıza olanak sağlayan Aspose.Words’ün raporlama motorudur. Veriler bir DataSet, DataTable, DataView, IDataReader veya bir dizi değerden olabilir. Posta birleştirme Veri kaynağında bulunan kayıtları inceleyecek ve bunları gerektiği gibi genişleterek belgedeki birleştirme alanlarına ekleyecektir.
Document belge genelindeki bilgileri depolar, örneğinStyles , BuiltInDocumentProperties ,CustomDocumentProperties , listeler ve makrolar. Bu nesnelerin çoğuna, ilgili özellikler aracılığıyla erişilebilir.Document.
TheDocument belgenin diğer tüm 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’a benzer. Belgenin içeriği programatik olarak serbestçe değiştirilebilir:
- Belgenin düğümlerine, örneğin yazılmış koleksiyonlar aracılığıyla erişilebilir
Sections,ParagraphCollectionvesaire. - Belgenin düğümleri, düğüm türlerine göre kullanılarak seçilebilir.
GetChildNodesveya bir XPath sorgusu kullanarakSelectNodesveyaSelectSingleNode. - İçerik düğümleri, belgenin herhangi bir yerinden kullanılarak eklenebilir veya kaldırılabilir
InsertBefore,InsertAfter,RemoveChildve temel sınıf tarafından sağlanan other yöntemleriCompositeNode. - Her düğümün biçimlendirme nitelikleri, o düğümün özellikleri aracılığıyla değiştirilebilir.
Kullanmayı düşününDocumentBuilder Bu, programlı olarak creation veya belge ağacını doldurma görevini basitleştirir.
TheDocument sadece içerebilirSection nesneler.
Microsoft Word’de geçerli bir belgenin en az bir bölümü olması gerekir.
Örnekler
DataTable’daki verilerle posta birleştirme işleminin nasıl gerçekleştirileceğ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 bir posta birleştirme için veri kaynağı olarak DataTable kullanmanın iki yolu bulunmaktadır.
// 1 - Tablonun tamamını kullanarak, tablodaki her satır için tek bir çıktı birleştirme belgesi oluşturun:
Document doc = CreateSourceDocExecuteDataTable();
doc.MailMerge.Execute(table);
doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.WholeTable.docx");
// 2 - Tablonun bir satırını kullanarak tek bir çıktı birleştirme belgesi oluşturun:
doc = CreateSourceDocExecuteDataTable();
doc.MailMerge.Execute(table.Rows[1]);
doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.OneRow.docx");
}
/// <summary>
/// Bir posta 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
- class DocumentBase
- ad alanı Aspose.Words
- toplantı Aspose.Words