DataPackage.ResourceMap 屬性

定義

命名空間:

Windows.ApplicationModel.DataTransfer

將 URI 對應至檔案。 用來確保參考的內容 (例如 HTML 內容中的影像) 新增至 DataPackage。

public:
 property IMap<Platform::String ^, RandomAccessStreamReference ^> ^ ResourceMap { IMap<Platform::String ^, RandomAccessStreamReference ^> ^ get(); };

IMap<winrt::hstring, RandomAccessStreamReference const&> ResourceMap();

public IDictionary<string,RandomAccessStreamReference> ResourceMap { get; }

var iMap = dataPackage.resourceMap;

Public ReadOnly Property ResourceMap As IDictionary(Of String, RandomAccessStreamReference)

屬性值

IMap<String,RandomAccessStreamReference>

IDictionary<String,RandomAccessStreamReference>

IMap<Platform::String,RandomAccessStreamReference>

IMap<winrt::hstring,RandomAccessStreamReference>

指定名稱/值組，指定具有對應 StreamReference 物件的 HTML 路徑。

範例

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

備註

HTML 內容通常包含其他檔案的參考。 最常見的範例是參考特定檔案的 img 標記。 若要確保影像會隨著 HTML 內容的其餘部分一起傳送，您必須使用 ResourceMap ，這會將 URI 字串對應至實際資料。 您可以在 如何共用 HTML 中深入瞭解。