StandardDataFormats 類別

定義

命名空間:

Windows.ApplicationModel.DataTransfer

包含傳回字串值的靜態屬性。 每個字串都會對應至已知的格式識別碼。 使用此類別可避免使用字串常數來指定資料格式的錯誤。

public ref class StandardDataFormats abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StandardDataFormats final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class StandardDataFormats

Public Class StandardDataFormats

繼承

Object Platform::Object IInspectable StandardDataFormats

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例示範 (如何使用 StandardDataFormats.Text) 或使用 StandardDataFormats.StorageItems) 擷取共用檔案或資料夾 (來擷取共用文字。 如需更多範例，請參閱 剪貼簿範例 和 ShareTarget 範例。

public async Task ActivateAsync(ShareTargetActivatedEventArgs args)
{
    ShareOperation shareOperation = args.ShareOperation;
    if (shareOperation.Data.Contains(StandardDataFormats.Text))
    {
        string text = await shareOperation.Data.GetTextAsync();

        // To output the text from this example, you need a TextBlock control
        // with a name of "sharedContent".
        sharedContent.Text = "Text: " + text;
    }

    if (shareOperation.Data.Contains(StandardDataFormats.StorageItems)) 
    {
        shareOperation.ReportStarted();
        IReadOnlyList<IStorageItem> storageItems = null;
        storageItems = await shareOperation.Data.GetStorageItemsAsync();
        string fileList = String.Empty;

        for (int index = 0; index < storageItems.Count; index++) 
        {
            fileList += storageItems[index].Name;
                if (index < storageItems.Count - 1) {
                    fileList += ", ";
                }
            }

        // To output the text from this example, you need a TextBlock control
        // with a name of "sharedContent".
        sharedContent.Text += "StorageItems: " + fileList + Environment.NewLine;

        shareOperation.ReportCompleted();
    }

    Window.Current.Content = this;
    Window.Current.Activate();
}

備註

DataPackage類別支援數種格式類型。 每當您需要指定格式時，建議您使用 StandardDataFormats 類別的屬性，而不是字串值。 這樣做可確保來源和目標應用程式之間的一致性。

DataPackage類別支援許多舊版格式，以便 UWP 應用程式和傳統型應用程式之間的互通性。 若要擷取這些格式，請將下列其中一個字串傳遞至 DataPackageView.GetDataAsync 方法，而不是 來自 StandardDataFormats 類別的值。

如果格式名稱為：	GetDataAsync () 擷取：
「AnsiText」	CF_TEXT的字串。
「DeviceIndependentBitmap」	對應至 CF_DIB 的 HGLOBAL 資料流程。
「DeviceIndependentBitmapV5」	對應至 CF_DIBV5 的 HGLOBAL 資料流程。
「DataInterchangeFormat」	對應至 CF_DIF 的 HGLOBAL 資料流程。
「EnhancedMetafile」	對應至 CF_ENHMETAFILE 之 HENHMETAFILE 的資料流程。
「地區設定」	對應至 CF_LOCALE 的 HGLOBAL 資料流程
「OEMText」	CF_OEMTEXT的字串。
「PenData」	對應至 CF_PENDATA 的 HGLOBAL 資料流程
「RiffAudio」	對應至 CF_RIFF 的 HGLOBAL 資料流程。
「SymbolicLink」	對應至 CF_SYLK 的 HGLOBAL 資料流程。
「TaggedImageFileFormat」	對應至 CF_TIFF 的 HGLOBAL 資料流程。
「WaveAudio」	對應至CF_WAVE的 HGLOBAL 資料流程。

Windows 執行階段對中繼檔提供有限的支援。 具體而言，Windows 執行階段：

• 支援轉譯中繼檔，但不支援建立它們。
• 支援CF_ENHMETAFILE格式 (「EnhancedMetafile」) ，但不支援CF_METAFILEPICT。
• 支援以 「EnhancedMetafile」 格式要求資料，但不支援提供資料;也就是說，呼叫 SetData("EnhancedMetafile", <data>) 將無法運作。
• 透過剪貼簿 API 提供有限的支援，以在 UWP 應用程式和傳統型應用程式之間交換中繼檔。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1803	17134	UserActivityJsonArray

屬性

ApplicationLink	唯讀屬性，會傳回對應至啟用連結格式的格式識別碼字串值。
Bitmap	唯讀屬性，會傳回對應至點陣圖格式的格式識別碼字串值。
Html	唯讀屬性，會傳回對應至 HTML 格式的格式識別碼字串值。
Rtf	唯讀屬性，會傳回與 RTF (RTF) 對應的格式識別碼字串值。
StorageItems	唯讀屬性，會傳回與檔案和資料夾) 儲存專案格式 (對應的格式識別碼字串值。
Text	唯讀屬性，會傳回對應至 Text 格式的格式識別碼字串值。
Uri	注意 在Windows 8.1之後，版本可能會變更或無法使用 URI。 請改用 ApplicationLink 或 WebLink。 唯讀屬性，會傳回對應到統一資源識別項 (URI) 格式的格式識別碼字串值。
UserActivityJsonArray	唯讀屬性，會傳回對應至 UserActivity JSON 陣列格式的格式識別碼字串值。
WebLink	唯讀屬性，會傳回對應至 Web 連結格式的格式識別碼字串值。