DataPackage.SetHtmlFormat(String) Methode

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Fügt dem DataPackage HTML-Inhalt hinzu.

public:
 virtual void SetHtmlFormat(Platform::String ^ value) = SetHtmlFormat;

void SetHtmlFormat(winrt::hstring const& value);

public void SetHtmlFormat(string value);

function setHtmlFormat(value)

Public Sub SetHtmlFormat (value As String)

Parameter

value

String

Platform::String

winrt::hstring

Der HTML-Inhalt.

Beispiele

public void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

async void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    string htmlExample = "<p>Here is our store logo: <img src='assets/logo.png'>.</p>";
    string fileExample = "assets\\logo.png";
    RandomAccessStreamReference streamRef = null;
    Windows.Storage.StorageFile file = await Windows.ApplicationModel.Package.Current.InstalledLocation.GetFileAsync(fileExample);
    try
    {
        streamRef = Windows.Storage.Streams.RandomAccessStreamReference.CreateFromFile(file);
    }
    catch (Exception ex)
    {
        // TODO: Handle the exception.
    }
    string htmlFormat = Windows.ApplicationModel.DataTransfer.HtmlFormatHelper.CreateHtmlFormat(htmlExample);
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share HTML Example";
    request.Data.Properties.Description = "An example of how to share HTML.";
    request.Data.SetHtmlFormat(htmlFormat);
    request.Data.ResourceMap[fileExample] = streamRef;
}

Hinweise

Um sicherzustellen, dass eine Ziel-App den HTML-Inhalt verarbeiten kann, verwenden Sie HtmlFormatHelper.CreateHtmlFormat. Es fügt die erforderlichen Header und andere Informationen der Zeichenfolge hinzu, die den HTML-Code enthält.

Wenn Ihre App das Auswählen oder Kopieren/Einfügen von HTML-Inhalten unterstützt, die img-Elemente enthalten, stellen Sie sicher, dass die src-Attribute vollqualifizierte absolute Pfade zu den Bildern und keine relativen Pfade angeben.