WebView.BuildLocalStreamUri(String, String) 方法

定义

命名空间:

Windows.UI.Xaml.Controls

创建可传递给 NavigateToLocalStreamUri 的 URI。

public:
 virtual Uri ^ BuildLocalStreamUri(Platform::String ^ contentIdentifier, Platform::String ^ relativePath) = BuildLocalStreamUri;

Uri BuildLocalStreamUri(winrt::hstring const& contentIdentifier, winrt::hstring const& relativePath);

public System.Uri BuildLocalStreamUri(string contentIdentifier, string relativePath);

function buildLocalStreamUri(contentIdentifier, relativePath)

Public Function BuildLocalStreamUri (contentIdentifier As String, relativePath As String) As Uri

参数

contentIdentifier

String

Platform::String

winrt::hstring

URI 引用的内容的唯一标识符。 这将定义 URI 的根。

relativePath

String

Platform::String

winrt::hstring

相对于根资源的路径。

返回

Uri Uri

通过组合和规范化 contentIdentifier 和 relativePath 创建的 URI。

示例

下面的代码示例演示如何将此方法用于解析程序，该解析程序将为应用包中的文件提供服务。 有关完整示例，请参阅 XAML WebView 控件示例。

public sealed partial class TestPage : Page
{
    // ... other code ...

    protected override void OnNavigatedTo(NavigationEventArgs e)
    {
        // The 'Host' part of the URI for the ms-local-stream protocol needs to be a combination of the package name
        // and an application-defined key, which identifies the specific resolver, in this case 'MyTag'.

        Uri url = webView4.BuildLocalStreamUri("MyTag","/Minesweeper/default.html");
        StreamUriWinRTResolver myResolver = new StreamUriWinRTResolver();

        // Pass the resolver object to the navigate call.
        webView4.NavigateToLocalStreamUri(url, myResolver);
    }
}

public sealed class StreamUriWinRTResolver : IUriToStreamResolver
{
    public IAsyncOperation<IInputStream> UriToStreamAsync(Uri uri)
    {
        if (uri == null)
        {
            throw new Exception();
        }
        string path = uri.AbsolutePath;

        // Because of the signature of the this method, it can't use await, so we 
        // call into a separate helper method that can use the C# await pattern.
        return GetContent(path).AsAsyncOperation();
    }

    private async Task<IInputStream> GetContent(string path)
    {
        // We use a package folder as the source, but the same principle should apply
        // when supplying content from other locations
        try
        {
            Uri localUri= new Uri("ms-appx:///html" + path);
            StorageFile f = await StorageFile.GetFileFromApplicationUriAsync(localUri);
            IRandomAccessStream stream = await f.OpenAsync(FileAccessMode.Read);
            return stream.GetInputStreamAt(0);
        }
        catch (Exception) { throw new Exception("Invalid path"); }
    }
}

另请参阅

• NavigateToLocalStreamUri(Uri, IUriToStreamResolver)
• XAML WebView 控件示例