Bagikan melalui

Membaca dari dan menulis ke properti dokumen

  • Artikel

Anda bisa menyimpan properti dokumen bersama dengan dokumen. aplikasi Office likasi menyediakan sejumlah properti bawaan, seperti penulis, judul, dan subjek. Topik ini memperlihatkan cara mengatur properti dokumen di Microsoft Office Excel dan Microsoft Office Word.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk aplikasi berikut: Excel; Powerpoint; Proyek; Kata. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Mengatur properti dokumen di Excel

Untuk bekerja dengan properti bawaan di Excel, gunakan properti berikut ini:

  • Dalam proyek tingkat dokumen, gunakan BuiltinDocumentProperties properti ThisWorkbook kelas .

  • Dalam proyek Add-in VSTO, gunakan BuiltinDocumentProperties properti Workbook objek.

    Properti ini mengembalikan DocumentProperties objek, yang merupakan kumpulan DocumentProperty objek. Anda dapat menggunakan Item properti koleksi untuk mengambil properti tertentu, baik berdasarkan nama atau menurut indeks dalam koleksi.

    Contoh kode berikut menunjukkan cara mengubah properti Nomor Revisi bawaan dalam proyek tingkat dokumen.

Untuk mengubah properti Nomor Revisi di Excel

  1. Tetapkan properti dokumen bawaan ke variabel.

    Microsoft.Office.Core.DocumentProperties properties;

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

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

  2. Menaikkan properti satu per Revision Number satu.

    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");
    }
}

Mengatur properti dokumen di Word

Untuk bekerja dengan properti bawaan di Word, gunakan properti berikut ini:

  • Dalam proyek tingkat dokumen, gunakan BuiltInDocumentProperties properti ThisDocument kelas .

  • Dalam proyek Add-in VSTO, gunakan BuiltInDocumentProperties properti Document objek.

    Properti ini mengembalikan DocumentProperties objek, yang merupakan kumpulan DocumentProperty objek. Anda dapat menggunakan Item properti koleksi untuk mengambil properti tertentu, baik berdasarkan nama atau menurut indeks dalam koleksi.

    Contoh kode berikut menunjukkan cara mengubah properti Subjek bawaan dalam proyek tingkat dokumen.

Untuk mengubah properti Subjek

  1. Tetapkan properti dokumen bawaan ke variabel.

    Microsoft.Office.Core.DocumentProperties properties;

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

  2. Ubah properti menjadi Subject "Whitepaper".

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

Pemrograman yang kuat

Contoh mengasumsikan bahwa Anda telah menulis kode di ThisWorkbook kelas dalam proyek tingkat dokumen untuk Excel, dan ThisDocument kelas dalam proyek tingkat dokumen untuk Word.

Meskipun Anda bekerja dengan Word dan Excel dan objeknya, Microsoft Office menyediakan daftar properti dokumen bawaan yang tersedia. Mencoba mengakses properti yang tidak terdefinisi menimbulkan pengecualian.

Konten terkait