다음을 통해 공유

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에 대한 스트림입니다.
"로캘"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>) 이 작동하지 않습니다.
  • UWP 앱과 데스크톱 앱 간에 메타파일을 교환하기 위한 클립보드 API를 통해 제한된 지원을 제공합니다.

버전 기록

Windows 버전 SDK 버전 추가된 값
1803 17134 UserActivityJsonArray

속성

ApplicationLink

활성화 링크 형식에 해당하는 ID 문자열 형식 값을 반환하는 읽기 전용 속성입니다.
Bitmap

비트맵 형식에 해당하는 형식 ID 문자열 값을 반환하는 읽기 전용 속성입니다.
Html

HTML 형식에 해당하는 ID 문자열 형식 값을 반환하는 읽기 전용 속성입니다.
Rtf

RTF(서식 있는 텍스트 형식)에 해당하는 형식 ID 문자열 값을 반환하는 읽기 전용 속성입니다.
StorageItems

스토리지 항목 형식(파일 및 폴더의 경우)에 해당하는 형식 ID 문자열 값을 반환하는 읽기 전용 속성입니다.
Text

텍스트 형식에 해당하는 ID 문자열 형식 값을 반환하는 읽기 전용 속성입니다.
Uri

참고

Windows 8.1 후 릴리스에 대해 URI를 변경하거나 사용할 수 없습니다. 대신 ApplicationLink 또는 WebLink를 사용합니다.

URI(Uniform Resource Identifier) 형식에 해당하는 ID 문자열 형식 값을 반환하는 읽기 전용 속성입니다.
UserActivityJsonArray

UserActivity JSON 배열 형식에 해당하는 형식 ID 문자열 값을 반환하는 읽기 전용 속성입니다.
WebLink

웹 링크 형식에 해당하는 ID 문자열 형식 값을 반환하는 읽기 전용 속성입니다.

적용 대상