StandardDataFormats Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.DataTransfer

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Enthält statische Eigenschaften, die Zeichenfolgenwerte zurückgeben. Jede Zeichenfolge entspricht einer bekannten Format-ID. Verwenden Sie diese Klasse, um Fehler bei der Verwendung von Zeichenfolgenkonstanten zum Angeben von Datenformaten zu vermeiden.

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

Vererbung: Object Platform::Object IInspectable StandardDataFormats

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird gezeigt, wie freigegebener Text (mithilfe von StandardDataFormats.Text) oder einer freigegebenen Datei oder eines freigegebenen Ordners (mithilfe von StandardDataFormats.StorageItems) abgerufen wird. Weitere Beispiele finden Sie im Zwischenablagebeispiel und im ShareTarget-Beispiel.

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();
}

Hinweise

Die DataPackage-Klasse unterstützt mehrere Formattypen. Wenn Sie ein Format angeben müssen, empfiehlt es sich, anstelle von Zeichenfolgenwerten die Eigenschaften der StandardDataFormats-Klasse zu verwenden. Dadurch wird die Konsistenz zwischen Quell- und Zielanwendungen sichergestellt.

Die DataPackage-Klasse unterstützt eine Reihe von Legacyformaten für die Interoperabilität zwischen UWP-Apps und Desktop-Apps. Um diese Formate abzurufen, übergeben Sie eine der folgenden Zeichenfolgen an die DataPackageView.GetDataAsync-Methode anstelle eines Werts aus der StandardDataFormats-Klasse .

Wenn der Formatname lautet:	GetDataAsync() ruft Folgendes ab:
"AnsiText"	Zeichenfolge für CF_TEXT.
"DeviceIndependentBitmap"	Stream für HGLOBAL entsprechend CF_DIB.
"DeviceIndependentBitmapV5"	Stream für HGLOBAL entsprechend CF_DIBV5.
"DataInterchangeFormat"	Stream für HGLOBAL entsprechend CF_DIF.
"EnhancedMetafile"	Stream für HENHMETAFILE entsprechend CF_ENHMETAFILE.
"Gebietsschema"	Stream für HGLOBAL entsprechend CF_LOCALE
"OEMText"	Zeichenfolge für CF_OEMTEXT.
"PenData"	Stream für HGLOBAL entsprechend CF_PENDATA
"RiffAudio"	Stream für HGLOBAL entsprechend CF_RIFF.
"SymbolicLink"	Stream für HGLOBAL entsprechend CF_SYLK.
"TaggedImageFileFormat"	Stream für HGLOBAL entsprechend CF_TIFF.
"WaveAudio"	Stream für HGLOBAL entsprechend CF_WAVE.

Die Windows-Runtime bietet eingeschränkte Unterstützung für Metadateien. Insbesondere Windows-Runtime:

Unterstützt das Rendern von Metadateien, aber nicht deren Erstellung.
Unterstützt das CF_ENHMETAFILE-Format ("EnhancedMetafile"), aber nicht CF_METAFILEPICT.
Unterstützt das Anfordern von Daten im Format "EnhancedMetafile", aber nicht die Bereitstellung; Das heißt, das Aufrufen SetData("EnhancedMetafile", <data>) funktioniert nicht.
Bietet eingeschränkte Unterstützung über die Zwischenablage-API für den Austausch von Metadateien zwischen UWP-Apps und Desktop-Apps.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1803	17134	UserActivityJsonArray

Eigenschaften

ApplicationLink	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem Aktivierungslinkformat entspricht.
Bitmap	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem Bitmap-Format entspricht.
Html	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem HTML-Format entspricht.
Rtf	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem Rich Text Format (RTF) entspricht.
StorageItems	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem Format des Speicherelementformats (für Dateien und Ordner) entspricht.
Text	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem Textformat entspricht.
Uri	Hinweis Der URI kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen ApplicationLink oder WebLink. Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem URI-Format (Uniform Resource Identifier) entspricht.
UserActivityJsonArray	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem JSON-Arrayformat userActivity entspricht.
WebLink	Eine schreibgeschützte Eigenschaft, die den Wert der Format-ID-Zeichenfolge zurückgibt, der dem Linkformat entspricht.

Gilt für:

Freigeben über