次の方法で共有

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 アプリとデスクトップ アプリ間の相互運用性のために、多くのレガシ形式がサポートされています。 これらの形式を取得するには、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 文字列値を返す読み取り専用プロパティ。

適用対象