Nasıl Yapılır: Belge Özelliklerinden Okuma ve Yazma

Makale
08/01/2011

Yukarıda listelenen Microsoft Office uygulamalarındaki belge ile birlikte belge özelliklerini saklayabilirsiniz. Bu uygulamalar yazar, başlık ve konu gibi birçok yerleşik özelliği içerir. Bu konu Microsoft Office Excel ve Microsoft Office Word belge özelliklerinin nasıl ayarlanacağını gösterir.

Mürekkepten videoya İlgili video gösterimi için, bkz. Nasıl Yaparım: Erişim ve özel belge özelliklerini Microsoft Word'de?.

Uygulama alanı: Bu konudaki bilgiler şu uygulamaların belge düzeyi projelerine ve uygulama düzeyi projelerine yöneliktir: Excel 2007 ve Excel 2010; PowerPoint 2007 ve PowerPoint 2010; Project 2007 ve Project 2010; Word 2007 ve Word 2010. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Excel Belge Özelliklerini Ayarlama

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

Belge düzeyi projesinde ThisWorkbook sınıfının BuiltinDocumentProperties özelliğini kullanın.
Uygulama düzeyi projesinde, Microsoft.Office.Interop.Excel.Workbook nesnesinin BuiltinDocumentProperties özelliğini kullanın.

Bu özellikler, DocumentProperty nesnelerinin bir koleksiyonu olan DocumentProperties nesnesi döner. Koleksiyonun Item özelliğini, koleksiyon içindeki belirli bir özelliği ismiyle veya diziniyle almak için kullanabilirsiniz.

Aşağıdaki kod örneği, bir belge düzeyi projesinde yerleşik Revision Number özelliğinin nasıl değiştirileceğini gösterir.

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

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

Dim properties As Microsoft.Office.Core.DocumentProperties

properties = DirectCast(Globals.ThisWorkbook.BuiltinDocumentProperties, _
    Microsoft.Office.Core.DocumentProperties)

Dim prop As Microsoft.Office.Core.DocumentProperty
prop = properties.Item("Revision Number")

Microsoft.Office.Core.DocumentProperties properties;

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

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

Revision Number özelliğini bir bir arttırın.

If prop.Value Is Nothing Then
    prop.Value = 1
Else
    Dim revision As Integer
    If Integer.TryParse(prop.Value.ToString(), revision) Then
        prop.Value = revision + 1
        MessageBox.Show("Revision Number = " & revision)
    Else
        MessageBox.Show("Revision Number = invalid value")
    End If
End If

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 Belge Özelliklerini Ayarlama

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

Belge düzeyi projesinde ThisDocument sınıfının BuiltInDocumentProperties özelliğini kullanın.
Uygulama düzeyi projesinde, Microsoft.Office.Interop.Word.Document nesnesinin BuiltInDocumentProperties özelliğini kullanın.

Aşağıdaki kod örneği, bir belge düzeyi projesinde yerleşik Subject özelliğinin nasıl değiştirileceğini gösterir.

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

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

Dim properties As Microsoft.Office.Core.DocumentProperties

properties = DirectCast(Globals.ThisDocument.BuiltInDocumentProperties, _
    Microsoft.Office.Core.DocumentProperties)

Microsoft.Office.Core.DocumentProperties properties;

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

Subject özelliğini "Whitepaper" olarak değiştirin.

' Set the Subject property.
properties.Item("Subject").Value = "Whitepaper"

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

Güçlü Programlama

Bu örnekler, kodunuzu Excel belge düzeyi projeleri için ThisWorkbook sınıfında ve Word belge düzeyi projeleri için ThisDocument sınıfında yazdığınızı varsayar.

Word ve Excel ve onların nesneleri ile çalışmanıza rağmen, Microsoft Office kullanılabilir yerleşik belge özelliklerinin listesini sağlar. Tanımlanmamış bir özelliğe erişmeye çalışmak özel durum yaratır.