StandardDataFormats クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.DataTransfer

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

文字列値を返す静的プロパティを格納します。各文字列は、既知の形式 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 アプリとデスクトップアプリ間の相互運用性のために、多くのレガシ形式がサポートされています。これらの形式を取得するには、StandardDataFormats クラスの値ではなく、次のいずれかの文字列を DataPackageView.GetDataAsync メソッドに渡します。

形式名が次の場合:	GetDataAsync() は次を取得します。
"AnsiText"	CF_TEXTの文字列。
"DeviceIndependentBitmap"	CF_DIBに対応する HGLOBAL のストリーム。
"DeviceIndependentBitmapV5"	CF_DIBV5に対応する HGLOBAL のストリーム。
"DataInterchangeFormat"	CF_DIFに対応する HGLOBAL のストリーム。
"EnhancedMetafile"	CF_ENHMETAFILEに対応する HENHMETAFILE のストリーム。
"Locale"	CF_LOCALEに対応する HGLOBAL のストリーム
"OEMText"	CF_OEMTEXTの文字列。
"PenData"	CF_PENDATAに対応する HGLOBAL のストリーム
"RiffAudio"	CF_RIFFに対応する HGLOBAL のストリーム。
"シンボリックリンク"	CF_SYLKに対応する HGLOBAL のストリーム。
"TaggedImageFileFormat"	CF_TIFFに対応する HGLOBAL のストリーム。
"WaveAudio"	CF_WAVEに対応する HGLOBAL のストリーム。

Windows ランタイムでは、メタファイルのサポートが制限されています。具体的には、Windows ランタイム:

メタファイルのレンダリングをサポートしますが、メタファイルの作成はサポートしていません。
CF_ENHMETAFILE形式 ("EnhancedMetafile") をサポートしますが、CF_METAFILEPICTはサポートしません。
"EnhancedMetafile" 形式のデータの要求をサポートしますが、提供しません。つまり、呼び出し SetData("EnhancedMetafile", <data>) は機能しません。
UWP アプリとデスクトップアプリの間でメタファイルを交換するために、クリップボード API を通じて限定的なサポートを提供します。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1803	17134	UserActivityJsonArray

プロパティ

ApplicationLink	アクティブ化リンク形式に対応する形式 ID 文字列値を返す読み取り専用プロパティ。
Bitmap	Bitmap 形式に対応する書式 ID 文字列値を返す読み取り専用プロパティ。
Html	HTML 形式に対応する形式 ID 文字列値を返す読み取り専用プロパティ。
Rtf	リッチテキスト形式 (RTF) に対応する書式 ID 文字列値を返す読み取り専用プロパティ。
StorageItems	ストレージアイテムの形式 (ファイルとフォルダーの場合) に対応する形式 ID 文字列値を返す読み取り専用プロパティ。
Text	Text 形式に対応する書式 ID 文字列値を返す読み取り専用プロパティ。
Uri	注意 uri は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、 ApplicationLink または WebLink を使用します。 Uniform Resource Identifier (URI) 形式に対応する形式 ID 文字列値を返す読み取り専用プロパティ。
UserActivityJsonArray	UserActivity JSON 配列形式に対応する形式 ID 文字列値を返す読み取り専用プロパティ。
WebLink	Web リンク形式に対応する書式 ID 文字列値を返す読み取り専用プロパティ。

適用対象