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 控制項範例