Windows Share 資料格式與檔案型別參考

請使用此參考資料來選擇正確的DataFormat宣告與 Windows Share 整合API。

DataFormat 參考表

DataFormat 傳送 API 接收 API 典型的應用程式類型
Text 設定文字 GetTextAsync 筆記應用程式、剪貼簿工具、一般文字
Uri / WebLink SetWebLink GetWebLinkAsync 瀏覽器、書籤、通訊應用程式
ApplicationLink SetApplicationLink GetApplicationLinkAsync 揭露深層連結的應用程式
Html SetHtmlFormat GetHtmlFormatAsync 電子郵件客戶端、富文本編輯器
Bitmap SetBitmap GetBitmapAsync 照片編輯器、影像檢視器
StorageItems 集合儲存物品 GetStorageItemsAsync 檔案管理器、雲端儲存應用程式
Rtf SetRtf GetRtfAsync Word 處理器、富文本編輯器

Tip

對於網址,永遠優先SetWebLinkSetText選擇 。 目標應用程式只有在內容以 URI 形式輸入時,才能產生豐富的連結預覽並正確處理導覽。

依應用程式類別分類的檔案類型宣告

使用這份速查表,選擇最狹窄的清單聲明組合 <uap:FileType> 。 宣告較少且更具體的類型,可以減少分享表中的雜訊,並防止應用程式顯示無法處理的內容。

應用程式分類 建議 <uap:FileType> 申報 其他資料格式
照片檢視器/編輯器 .jpg .jpeg .png .gif .bmp .heic .webp BitmapStorageItems
影片播放器 .mp4 .mov .avi .mkv .wmv StorageItems
音響播放器 .mp3 .flac .wav .aac .m4a StorageItems
文件編輯器 .pdf .docx .xlsx .pptx .txt StorageItems
連結處理程式 / 瀏覽器 (無檔案類型) UriWebLink
訊息應用程式 (無檔案類型或特定附件類型) UriWebLinkStorageItems
筆記應用程式 .txt .md TextStorageItems
雲端儲存/檔案移動工具 <uap:SupportsAnyFileType /> StorageItems

Important

<uap:SupportsAnyFileType /> 僅適用於一般用途的檔案搬運機。 對於其他所有應用程式類別,請宣告特定的檔案副檔名。 過度寬泛的宣告是最常見的目標股價錯誤。