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 を共有する方法」を参照してください。