Share via

Belge özelliklerinden okuma ve belge özelliklerine yazma

  • Makale

Belge özelliklerini bir belgeyle birlikte depolayabilirsiniz. Office uygulaması'ler yazar, başlık ve konu gibi bir dizi yerleşik özellik sağlar. Bu konuda, Microsoft Office Excel ve Microsoft Office Word'de belge özelliklerinin nasıl ayarlanacağı gösterilmektedir.

Şunlar için geçerlidir: Bu konudaki bilgiler, aşağıdaki uygulamalar için belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir: Excel; Powerpoint; Proje; Kelime. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Excel'de belge özelliklerini ayarlama

Excel'de yerleşik özelliklerle çalışmak için aşağıdaki özellikleri kullanın:

  • Belge düzeyindeki bir projede BuiltinDocumentProperties sınıfının özelliğini ThisWorkbook kullanın.

  • VSTO Eklentisi projesinde bir Workbook nesnenin BuiltinDocumentProperties özelliğini kullanın.

    Bu özellikler nesne koleksiyonu DocumentProperty olan bir nesnesi döndürürDocumentProperties. Belirli bir özelliği almak için koleksiyondaki ada veya dizine göre koleksiyonunun özelliğini kullanabilirsiniz Item .

    Aşağıdaki kod örneği, belge düzeyi projesinde yerleşik Düzeltme Numarası özelliğinin nasıl değiştireceğini gösterir.

Excel'de Düzeltme Numarası özelliğini değiştirmek için

  1. Yerleşik belge özelliklerini bir değişkene atayın.

    Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisWorkbook.BuiltinDocumentProperties; 

Microsoft.Office.Core.DocumentProperty prop;
prop = properties["Revision Number"];

  2. Revision Number Özelliği bir artır.

    if (prop.Value == null)
{
    prop.Value = 1;
}
else
{
    int revision;
    if (int.TryParse((string)prop.Value, out revision))
    {
        prop.Value = revision + 1;
        MessageBox.Show("Revision Number = " + revision);
    }
    else
    {
        MessageBox.Show("Revision Number = invalid value");
    }
}

Word'de belge özelliklerini ayarlama

Word'de yerleşik özelliklerle çalışmak için aşağıdaki özellikleri kullanın:

  • Belge düzeyindeki bir projede BuiltInDocumentProperties sınıfının özelliğini ThisDocument kullanın.

  • VSTO Eklentisi projesinde bir Document nesnenin BuiltInDocumentProperties özelliğini kullanın.

    Bu özellikler nesne koleksiyonu DocumentProperty olan bir nesnesi döndürürDocumentProperties. Belirli bir özelliği almak için koleksiyondaki ada veya dizine göre koleksiyonunun özelliğini kullanabilirsiniz Item .

    Aşağıdaki kod örneği, belge düzeyindeki bir projede yerleşik Konu özelliğinin nasıl değiştireceğini gösterir.

Konu özelliğini değiştirmek için

  1. Yerleşik belge özelliklerini bir değişkene atayın.

    Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisDocument.BuiltInDocumentProperties;

  2. Subject özelliğini "Teknik İnceleme" olarak değiştirin.

    // Set the Subject property. 
properties["Subject"].Value = "Whitepaper";

Sağlam programlama

Örneklerde, excel için belge düzeyi projesinde sınıfındaki ThisWorkbook kodu ve ThisDocument Word için belge düzeyindeki bir projede yazdığınız varsayılır.

Word ve Excel ve nesneleriyle çalışıyor olmanıza rağmen, Microsoft Office kullanılabilir yerleşik belge özelliklerinin listesini sağlar. Tanımlanmamış bir özelliğe erişmeye çalışıldığında özel durum oluşur.

İlgili içerik