Belge Özellikleriyle Çalışma
Belge özellikleri, belgenizle ilgili bazı yararlı bilgilerin depolanmasına izin verir. Bu özellikler iki gruba ayrılabilir:
- Belge başlığı, yazar adı, belge istatistikleri ve diğerleri gibi değerleri içeren sistem veya yerleşik.
- Kullanıcı tanımlı veya özel, kullanıcının hem adı hem de değeri tanımlayabileceği ad-değer çiftleri olarak sağlanır.
API ve Sürüm Numarası hakkındaki bilgilerin doğrudan çıktı belgelerine yazıldığını bilmek yararlıdır. Örneğin, bir belgeyi PDF ‘e dönüştürdükten sonra Aspose.Words, “Uygulama” alanını “Aspose.Words” ve “PDF Üretici” alanını “ile doldurur.Aspose.Words için C++ YY.M.N”, burada YY.M.N, dönüşüm için kullanılan Aspose.Words sürümüdür. Daha fazla ayrıntı için bkz. Çıktı Belgelerinde Yer Alan Üretici veya Üretici Adı.
Belge Özelliklerine Erişin
Aspose.Words içindeki belge özelliklerine erişmek için:
-
BuiltInDocumentProperties yerleşik özellikler elde etmek için.
-
CustomDocumentProperties özel özellikler elde etmek için.
BuiltInDocumentProperties
BuiltInDocumentProperties
DocumentProperty sınıfı, bir belge özelliğinin adını, değerini ve türünü almanızı sağlar. Value bir nesne döndürür, ancak özellik değerini belirli bir türe dönüştürmenize izin veren bir dizi yöntem vardır. Özelliğin ne tür olduğunu öğrendikten sonra, uygun türün değerini elde etmek için DocumentProperty.ToString ve DocumentProperty. ToInt gibi DocumentProperty.ToXXX yöntemlerden birini kullanabilirsiniz.
Aşağıdaki kod örneği, bir belgedeki tüm yerleşik ve özel özelliklerin nasıl numaralandırılacağını gösterir:
Microsoft Word ‘da “Dosya → Özellikler” menüsünü kullanarak belge özelliklerine erişebilirsiniz.
Belge Özellikleri Ekleme veya Kaldırma
Aspose.Words kullanarak yerleşik belge özellikleri ekleyemez veya kaldıramazsınız. Yalnızca değerlerini değiştirebilir veya güncelleyebilirsiniz.
Aspose.Words ile özel belge özellikleri eklemek için, yeni özellik adını ve uygun türün değerini ileterek Add yöntemini kullanın. Yöntem, yeni oluşturulan DocumentProperty nesnesini döndürür.
Özel özellikleri kaldırmak için, kaldırılacak özellik adını ileterek Remove yöntemini veya özelliği dizine göre kaldırmak için RemoveAt yöntemini kullanın. Clear yöntemini kullanarak tüm özellikleri de kaldırabilirsiniz.
Aşağıdaki kod örneği, bir belgede belirli bir ada sahip özel bir özelliğin bulunup bulunmadığını denetler ve birkaç özel belge özelliği daha ekler:
Aşağıdaki kod örneği, özel bir belge özelliğinin nasıl kaldırılacağını gösterir:
Yerleşik Belge Özelliklerini Güncelle
Aspose.Words, Microsoft Word’in bazı özelliklerde yaptığı gibi belge özelliklerini otomatik olarak güncellemez, ancak bazı istatistiksel yerleşik belge özelliklerini güncellemek için bir yöntem sağlar. Aşağıdaki özellikleri yeniden hesaplamak ve güncellemek için UpdateWordCount yöntemini çağırın:
İçeriğe Bağlı Yeni Bir Özel Özellik Oluşturma
Aspose.Words içeriğe bağlı yeni bir özel belge özelliği oluşturmak için AddLinkToContent yöntemini sağlar. Bu özellik, yeni oluşturulan özellik nesnesini döndürür veya LinkSource geçersiz ise null değerini döndürür.
Aşağıdaki kod örneği, özel bir özelliğe bağlantının nasıl yapılandırılacağını gösterir:
Belge Değişkenlerini Al
Variables özelliğini kullanarak bir belge değişkenleri koleksiyonu alabilirsiniz. Değişken adları ve değerleri dizelerdir.
Aşağıdaki kod örneği, belge değişkenlerinin nasıl numaralandırılacağını gösterir:
Kişisel Bilgileri Belgeden Kaldırma
Bir Word belgesini başkalarıyla paylaşmak istiyorsanız, yazar adı ve şirket gibi kişisel bilgileri kaldırmak isteyebilirsiniz. Bunu yapmak için, Microsoft Word ‘in belgeyi kaydettikten sonra tüm kullanıcı bilgilerini açıklamalardan, düzeltmelerden ve belge özelliklerinden kaldıracağını belirten bayrağı ayarlamak için RemovePersonalInformation özelliğini kullanın.
Aşağıdaki kod örneği, kişisel bilgilerin nasıl kaldırılacağını gösterir: