屬性處理常式最佳做法和常見問題

檔案的某些屬性是由檔案系統資料來源提供，例如：

• PKEY_FileName
• PKEY_Extension
• PKEY_ModifiedTime

一般而言，屬性處理常式無法提供這些屬性的值。 不過，在某些情況下，您可以根據屬性處理常式提供的註冊資訊覆寫這些屬性。 屬性處理常式會將要覆寫的屬性名稱填入HKEY_CLASSES_ROOT\CLSID\{handler clsid}\OverrideFileSystemProperties。 這僅限於下列系統具有知識的一組固定屬性。

下列屬性值支援覆寫：

• System.Kind
• System.FileName
• System.IsPinnedToNameSpaceTree
• System.ItemNameDisplay
• System.SFGAOFlags
• System.ItemPathDisplay
• System.ItemPathDisplayNarrow
• System.ItemFolderNameDisplay
• System.ItemFolderPathDisplay
• System.ItemFolderPathDisplayNarrow

如需所有 Shell 屬性的完整清單，請參閱 Shell 屬性。

有兩個基本選項可用來以 XML 為基礎的檔案格式儲存屬性：

• 根據檔的 XML 架構，使用 XML 元素和屬性來儲存每個屬性。 此方法更「XML 易記」。
• 將整個屬性存放區序列化為記憶體二進位大型物件， (BLOB) 、將 BLOB 轉換成 base64 編碼字串，然後將該字串儲存在 XML 中。 這是這兩種方法的較簡單方法，可用來簡單提供開啟中繼資料的支援。

例如，某些處理常式可能會結合這些方法，以標準 XML 格式儲存一些重要的值，並將其餘值儲存在 BLOB 中。

某些屬性衍生自檔案的特定屬性。 例如， System.Image.Dimensions 屬性是由影像檔案中影像的實際維度所決定。 由於屬性處理常式無法變更這類屬性值，因此它們會標示 isInnate="true" 在屬性描述中。 其他屬性是從特定屬性的一部分計算，或藉由匯總多個屬性的值來計算。 由於這些「計算」屬性的更新會建立模棱兩可的方式，因此應該如何變更「來源」值，因此計算屬性應該在屬性描述中標示 isInnate="true" ，或回報為唯讀。 後者的選項是指示處理常式從 IPropertyStoreCapabilities：：IsPropertyWritable傳回S_FALSE。

Windows 搜尋服務索引子會以系統服務的形式執行，而且無法載入儲存在使用者設定檔目錄中的 DLL。 如果您要使用 Microsoft Visual Studio 建置和偵錯，它會將 DLL 放在使用者設定檔 (，因此索引子不會載入) 。 若要解決此問題，請將設定檔資料夾外部的 DLL (複製到 C：\Program Files\YourAppName) ，並在該處註冊。

如需開發屬性處理常式以使用 Windows 搜尋索引子的特定指引，請參閱 開發 Windows 搜尋的屬性處理常式。

並非所有屬性存放區物件的用戶端都會使用這些方法。 有些用戶端知道他們打算透過 PKEY 名稱) 直接要求 (的屬性，或透過屬性描述清單接收屬性資訊。 屬性探索方法支援數個其他案例。 如果屬性不需要參與這些案例，則不需要列舉。 因此，屬性處理常式可能會針對未透過IPropertyStore：：GetCount 和 IPropertyStore：：GetAt方法探索的屬性產生非VT_EMPTY值。

不過，如果符合下列任何條件，則應透過這些方法顯示內容：

• 如果屬性已編制索引，使其可供搜尋： 這表示它包含在 Windows 搜尋屬性存放區中， isColumn = "true" (屬性描述架構) 或可供全文檢索搜尋 (inInvertedIndex = "true") 。 如果沒有這些旗標或沒有屬性描述，類型 「string」 的屬性會自動新增至反向索引，以啟用搜尋。 由於已知屬性清單 (屬性系統中已安裝的屬性描述) 非常龐大， (超過 800 個屬性) ，因此對於在屬性系統中註冊的每個屬性，要求每個屬性處理常式並不實用。 相反地，索引程式會針對索引的每個專案，從屬性處理常式列舉相關屬性，並使用列舉屬性的值來建置全文檢索索引。
• 如果當專案的屬性集重複時，應該複製屬性： 若要實作「複製屬性集」函式，來源專案會建立應該透過 IPropertyStore：：GetCount 和 IPropertyStore：：GetAt 方法複製的屬性。 不需要複製或不合理複製的屬性不應該包含在內。
• 如果屬性值不是空的 (VT_EMPTY) ： 空的屬性值不適用於用戶端。 當用戶端嘗試傳回空的屬性值時，會傳回VT_EMPTY的值。 因此，不應該列舉具有空白值的屬性。
• 如果在叫用「移除屬性」函式時應移除屬性： 這項功能存在以保護隱私權;它會透過列舉來探索屬性處理常式中的所有值，並移除使用者選取的每個值以供移除。

For information about support for open metadata, see "File Types that Support Open Metadata" in File Types.

不會。 VT_Null值將會在呼叫IPropertyStore：：GetValue 和 IPropertyStore：：SetValue時轉換成VT_EMPTY。

一般而言，表示日期/時間值的屬性應該使用VT_FILETIME來表示。 不過，許多資料來源會以字串形式提供這項資訊。 PropVariantChangeType協助程式 API 支援將某些字串日期格式強制轉換成FILETIME值，如下表所示。

是的。 某些屬性處理常式實作不支援寫入屬性值。 這些屬性處理常式應該會在對 傳遞 STGM_READWRITE 的 IInitializeXXX：：Initialize 呼叫時，或在 對 IPropertyStore：：SetValue的任何呼叫上傳回STGM_E_ACCESSDENIED。

在呼叫 IPropertyStore：：SetValue時，在STGM_READ模式中開啟的所有屬性處理常式都應該傳回STGM_E_ACCESSDENIED。

是的。 在架構系統中，屬性會批註為唯讀 (，包括具有 isInnate = "true") 或讀取/寫入的屬性。 不支援撰寫特定屬性的屬性處理常式，架構應該可寫入，應該實作 IPropertyStoreCapabilities ，並在呼叫 IPropertyStoreCapabilities：：IsPropertyWritable 時傳回S_FALSE。 這表示在這個處理常式和這個檔案的內容中，屬性無法寫入。

相關主題

瞭解屬性處理常式

使用種類名稱

使用屬性清單

初始化屬性處理常式

註冊和散發屬性處理常式