StandardDataFormats 类

定义

命名空间:

Windows.ApplicationModel.DataTransfer

包含返回字符串值的静态属性。 每个字符串对应于一个已知的格式 ID。 使用此类可避免使用字符串常量指定数据格式时出现错误。

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 运行时：

• 支持呈现图元文件，但不支持创建图元文件。
• 支持 (“EnhancedMetafile”) CF_ENHMETAFILE格式，但不支持CF_METAFILEPICT。
• 支持以“EnhancedMetafile”格式请求数据，但不提供;也就是说，调用 SetData("EnhancedMetafile", <data>) 不起作用。
• 通过剪贴板 API 提供有限支持，用于在 UWP 应用和桌面应用之间交换图元文件。

版本历史记录

Windows 版本	SDK 版本	增值
1803	17134	UserActivityJsonArray

属性

ApplicationLink	一个只读属性，返回与激活链接格式对应的格式 ID 字符串值。
Bitmap	一个只读属性，返回对应于位图格式的格式 ID 字符串值。
Html	一个只读属性，返回与 HTML 格式对应的格式 ID 字符串值。
Rtf	一个只读属性，返回 RTF) RTF 格式 (格式 ID 字符串值。
StorageItems	一个只读属性，返回与文件和文件夹) 的存储项格式 (对应的格式 ID 字符串值。
Text	一个只读属性，返回与 Text 格式对应的格式 ID 字符串值。
Uri	注意 Windows 8.1后，URI 可能会更改或不可用于发布。 请改用 ApplicationLink 或 WebLink。 一个只读属性，返回与统一资源标识符 (URI) 格式对应的格式 ID 字符串值。
UserActivityJsonArray	一个只读属性，返回对应于 UserActivity JSON 数组格式的格式 ID 字符串值。
WebLink	一个只读属性，返回与 Web 链接格式对应的格式 ID 字符串值。