วิธีทำงานกับคุณสมบัติของเอกสารใน .NET

ขั้นตอนที่ 1: อ่านและตั้งค่าคุณสมบัติเอกสารที่มีอยู่ในตัว

Document.BuiltInDocumentProperties คืนค่าเป็นคอลเลกชัน BuiltInDocumentProperties. เนื่องจากเป็นชุดคุณสมบัติที่คงที่และทราบล่วงหน้า ค่าจะถูกอ่านและเขียนเป็นสมาชิกทั่วไปแทนการค้นหาด้วยชื่อ — ตัวอย่างเช่น BuiltInDocumentProperties.Author, .Title, .Subject, .Manager, .Company, .Category, .Keywords, และ .Comments สำหรับฟิลด์เชิงบรรยาย, หรือ .CreatedTime, .LastSavedTime, .LastPrinted, และ .LastSavedBy สำหรับเวลาประทับ. สถิติเช่น .Characters, .CharactersWithSpaces, .Lines, และ .Bytes ก็เปิดให้เข้าถึงในลักษณะเดียวกัน, พร้อมกับ .Template และ .HyperlinkBase.

ขั้นตอนที่ 2: เพิ่มคุณสมบัติเอกสารที่กำหนดเอง

Document.CustomDocumentProperties คืนค่าชุด CustomDocumentProperties สำหรับเมตาดาต้าที่กำหนดโดยแอปพลิเคชันซึ่งไม่ได้เป็นส่วนหนึ่งของชุดที่ Word มีมาโดยตรง เรียกใช้หนึ่งใน overload ของ Add(name, value) พร้อมชื่อและค่าที่มีประเภท — สตริง, ตัวเลข, บูลีน หรือวันที่ ขึ้นอยู่กับ overload ที่ตรงกับประเภทของค่า — เพื่อสร้างคุณสมบัติใหม่.

ขั้นตอนที่ 3: เชื่อมคุณสมบัติกำหนดเองกับเนื้อหาเอกสาร

แทนค่าคงที่ คุณสมบัติกำหนดเองสามารถติดตามช่วงเนื้อหาที่มีเครื่องหมายบุ๊กมาร์กเพื่อให้ค่าของมันสอดคล้องกับเนื้อหานั้น เรียก CustomDocumentProperties.AddLinkToContent(name, linkSource) โดยส่งชื่อบุ๊กมาร์กเป็น linkSource แทนการทำการซิงค์ค่าคงที่ด้วยตนเองทุกครั้งที่เนื้อหาที่เชื่อมโยงเปลี่ยนแปลง.

ขั้นตอนที่ 4: ค้นหา ตรวจสอบ และลบคุณสมบัติ

ทั้ง BuiltInDocumentProperties และ CustomDocumentProperties สืบทอดมาจาก DocumentPropertyCollection แบบนามธรรม ดังนั้นจึงตรวจสอบได้แบบเดียวกัน: การเข้าถึงโดยชื่อ (เช่น properties[name]) จะดึงคุณสมบัติ, Contains(name) ตรวจสอบว่ามีอยู่หรือไม่, IndexOf(name) คืนค่าตำแหน่งของมัน, และ Count รายงานจำนวนคุณสมบัติที่ชุดนี้มี. เรียก Contains(name) ก่อนการเข้าถึงโดยชื่อเมื่อคุณสมบัติกำหนดเองอาจไม่มีอยู่ เพื่อหลีกเลี่ยงการจัดการคุณสมบัติที่หายไปเป็นเส้นทางของข้อยกเว้น. ลบคุณสมบัติด้วย Remove(name) หรือ RemoveAt(index), หรือเคลียร์คุณสมบัติทั้งหมดในชุดด้วย Clear().

ขั้นตอนที่ 5: อ่านค่าของคุณสมบัติกำหนดเองโดยไม่ต้องรู้ประเภทล่วงหน้า

อ็อบเจ็กต์ DocumentProperty มี Name, Value ที่ไม่มีประเภท, และ Type — ค่าตัวแปร enum ของ PropertyType: Boolean, DateTime, Double, Number, String, StringArray, ObjectArray, ByteArray, หรือ Other. เนื่องจาก Value ไม่มีประเภท ให้ใช้ accessor ที่มีประเภทตรงกันแทนการแคสต์โดยตรง: ToInt(), ToDouble(), ToDateTime(), ToBool(), ToByteArray(), หรือ ToString(). ตรวจสอบ IsLinkToContent และ LinkSource เพื่อดูว่าคุณสมบัติเชื่อมโยงกับเนื้อหาเอกสาร (ดูขั้นตอนที่ 3) หรือเป็นค่าคงที่.

ขั้นตอนที่ 6: ตรวจสอบสถานะการปกป้องของเอกสาร

BuiltInDocumentProperties.Security รายงานค่าที่เป็น DocumentSecurity ซึ่งอธิบายเมตาดาต้าการป้องกันที่จัดเก็บของเอกสาร: None, PasswordProtected, ReadOnlyRecommended, ReadOnlyEnforced หรือ ReadOnlyExceptAnnotations. อ่านคุณสมบัตินี้ก่อนตัดสินใจว่าต้องการการประมวลผลที่เกี่ยวกับการป้องกันเพิ่มเติมหรือไม่บนเอกสารที่โหลดแล้ว.