指南

介绍

安装

指南

故障排除

迁移

      // 返回后退/前进列表中的条目数。
int entryCount = navigation.EntryCount;
// 删除索引处的导航条目。
for (int i = entryCount - 2; i >= 0; i--) {
    bool success = navigation.RemoveEntryAt(i);
    Console.WriteLine("Navigation entry at index " + i +
            " has been removed successfully? " + success);
}

    

      ' 返回后退/前进列表中的条目数。
Dim entryCount As Integer = navigation.EntryCount
' 删除索引处的导航条目。
For i As Integer = entryCount - 2 To 0 Step -1
    Dim success As Boolean = navigation.RemoveEntryAt(i)
    Console.WriteLine("Navigation entry at index " & i & 
                      " has been removed successfully? " & success)
Next

    

过度滚动历史导航

在硬件加速渲染模式下，DotNetBrowser 允许通过在带有触摸屏的设备上向左/向右滑动来后退/前进导航。默认情况下，过度滚动导航是禁用的。要启用它，请使用 IBrowserSettings.OverscrollHistoryNavigationEnabled 属性：

      browser.Settings.OverscrollHistoryNavigationEnabled = true;

    

      browser.Settings.OverscrollHistoryNavigationEnabled = True

    

过滤 URL

您可以决定是否忽略特定 URL 的导航请求。

请参阅下面的代码示例，其中展示了如何忽略所有以 https://www.google 开头的 URL 的导航请求：

      navigation.StartNavigationHandler = 
    new Handler<StartNavigationParameters, StartNavigationResponse>((p) =>
    {
        // 忽略以 "https://www.google" 开头的 URL 
        // 导航请求。
        if (p.Url.StartsWith("https://www.google"))
        {
            return StartNavigationResponse.Ignore();
        }
        return StartNavigationResponse.Start();
    });

    

      navigation.StartNavigationHandler = 
    New Handler(Of StartNavigationParameters, StartNavigationResponse)(Function(p)
        ' 忽略以 "https://www.google" 开头的 URL 
        ' 导航请求。
        If p.Url.StartsWith("https://www.google") Then
            Return StartNavigationResponse.Ignore()
        End If
        Return StartNavigationResponse.Start()
    End Function)

    

过滤资源

SendUrlRequestHandler “处理程序可让您确定 HTML、图像、JavaScript 或 CSS 文件、favicon 等资源是否已加载。默认情况下，加载所有资源。要修改默认行为，请在您决定取消或加载哪些资源的地方注册您自己的处理程序实现。

请参阅下面的代码示例，了解如何抑制所有图像：

      engine.Network.SendUrlRequestHandler =
    new Handler<SendUrlRequestParameters, SendUrlRequestResponse>(p =>
    {
        if (p.UrlRequest.ResourceType == ResourceType.Image)
        {
            return SendUrlRequestResponse.Cancel();
        }
        return SendUrlRequestResponse.Continue();
    });

    

      engine.Network.SendUrlRequestHandler = 
    New Handler(Of SendUrlRequestParameters, SendUrlRequestResponse)(Function(p)
        If p.UrlRequest.ResourceType = ResourceType.Image Then
            Return SendUrlRequestResponse.Cancel()
        End If
        Return SendUrlRequestResponse.Continue()
    End Function)

    

导航事件

加载网页是一个复杂的过程，其中会触发导航事件。下图展示了加载网页时可能触发的导航事件的顺序： Navigation Events Flow

加载开始

要在内容加载开始时获得通知，请使用 LoadStarted 事件。请参阅以下代码示例：

      navigation.LoadStarted += (s, e) => {};

    

      AddHandler navigation.LoadStarted, Sub(s, e)
End Sub

该事件对应于标签页的加载指示器开始旋转的时刻。

加载完成

要在内容加载完成时获得通知，请使用 LoadFinished 事件。例如：

      navigation.LoadFinished += (s, e) => {};

    

      AddHandler navigation.LoadFinished, Sub(s, e)
End Sub

该事件对应于标签页的加载指示器停止旋转的时刻。

加载进度

LoadProgressChanged 事件允许获取有关加载进度的通知：

      navigation.LoadProgressChanged += (s, e) =>
{
    // 表示网页加载进度的值。
    double progress = e.Progress;
};

    

      AddHandler navigation.LoadProgressChanged, Sub(s, e)
    ' 表示网页加载进度的值。
    Dim progress As Double = e.Progress
End Sub

    

导航开始

要在导航开始时获得通知，请使用 NavigationStarted 事件。请参阅以下代码示例：

      navigation.NavigationStarted += (s, e) => 
{
    string url = e.Url;
    // 指示导航是否
    // 将在同一文档范围内执行。
    bool isSameDocument = e.IsSameDocument;
};

    

      AddHandler navigation.NavigationStarted, Sub(s, e)
    Dim url As String = e.Url
    ' 只是导航是否
    ' 将在同一文档范围内执行。
    Dim isSameDocument As Boolean = e.IsSameDocument
End Sub

    

导航停止

要在导航停止时获得通知，请使用 NavigationStopped 事件。请参阅以下代码示例：

      navigation.NavigationStopped += (s, e) => {};

    

      AddHandler navigation.NavigationStopped, Sub(s, e)
End Sub

当使用 Navigation.stop() 方法停止导航时会触发此事件。

导航重定向

要在导航重定向到新 URL 时获得通知，请使用 NavigationRedirected 事件。请参阅以下代码示例：

      navigation.NavigationRedirected += (s, e) => {
    // 导航重定向 URL。
    string url = e.Url;
};

    

      AddHandler navigation.NavigationRedirected, Sub(s, e)
    ' 导航重定向 URL。
    Dim url As String = e.Url
End Sub

    

导航完成

要在导航完成时获得通知，请使用 NavigationFinished 事件。请参阅以下代码示例：

      navigation.NavigationFinished += (s, e) => {
    string url = e.Url;
    IFrame frame = e.Frame;
    bool hasCommitted = e.HasCommitted;
    bool isSameDocument = e.IsSameDocument;
    bool isErrorPage = e.IsErrorPage;
    if (isErrorPage) {
        NetError error = e.ErrorCode;
    }
};

    

      AddHandler navigation.NavigationFinished, Sub(s, e)
    Dim url As String = e.Url
    Dim frame As IFrame = e.Frame
    Dim hasCommitted As Boolean = e.HasCommitted
    Dim isSameDocument As Boolean = e.IsSameDocument
    Dim isErrorPage As Boolean = e.IsErrorPage
    If isErrorPage Then
        Dim [error] As NetError = e.ErrorCode
    End If
End Sub

    

当导航被提交、中止或被新导航替换时，将触发此事件。要知道导航是否已提交，请使用 NavigationFinishedEventArgs.HasCommitted。要了解导航是否导致错误页面，请使用 NavigationFinishedEventArgs.IsErrorPage。

如果由于导航已提交而调用该事件，则文档加载仍将继续进行。

该事件由 same-document（在同一文档范围内）的导航触发，比如片段导航或 window.history.pushState()/window.history.replaceState()，这些导航不会导致文档的更改。使用 NavigationFinishedEventArgs.IsSameDocument 属性来检查是否是同一文档导航。

框架加载完成

要在 IFrame 中的内容加载完成时获得通知，请使用 FrameLoadFinished 事件。请参阅以下代码示例：

      navigation.FrameLoadFinished += (s, e) =>
{
    string url = e.ValidatedUrl;
    IFrame frame = e.Frame;
};

    

      AddHandler navigation.FrameLoadFinished, Sub(s, e)
    Dim url As String = e.ValidatedUrl
    Dim frame As IFrame = e.Frame
End Sub

    

此事件对应于 Frame 中的内容已完全加载的时刻。

框架加载失败

要在 Frame 中的内容加载因某种原因失败时获得通知，请使用 FrameLoadFailed 事件。请参阅以下代码示例：

      navigation.FrameLoadFailed += (s, e) =>
{
    string url = e.ValidatedUrl;
    NetError error = e.ErrorCode;
};

    

      AddHandler navigation.FrameLoadFailed, Sub(s, e)
    Dim url As String = e.ValidatedUrl
    Dim [error] As NetError = e.ErrorCode
End Sub

    

框架文件加载完成

要在 Frame 中的文档加载完成时获得通知，请使用FrameDocumentLoadFinished 事件。请参阅以下代码示例：

      navigation.FrameDocumentLoadFinished += (s, e) => 
{
    IFrame frame = e.Frame;
};

    

      AddHandler navigation.FrameDocumentLoadFinished, Sub(s, e)
    Dim frame As IFrame = e.Frame
End Sub

    

此时，延迟脚本被执行，标记为 document_end 的内容脚本被注入到框架中。

自定义错误页面

要覆盖标准 Chromium 错误页面，请使用 ShowHttpErrorPageHandler 和 ShowNetErrorPageHandler 处理程序，分别处理 HTTP 错误（如 404 Not Found）或网络错误（如 ERR_CONNECTION_REFUSED）。请参阅以下示例：

HTTP 错误页面

      browser.Navigation.ShowHttpErrorPageHandler =
    new Handler<ShowHttpErrorPageParameters, ShowHttpErrorPageResponse>(arg =>
    {
        string url = arg.Url;
        HttpStatusCode httpStatusCode = arg.HttpStatus;
        return ShowHttpErrorPageResponse.Show("HTTP Error web page:" + httpStatusCode);
    });

    

      browser.Navigation.ShowHttpErrorPageHandler = 
    New Handler(Of ShowHttpErrorPageParameters, ShowHttpErrorPageResponse)(Function(arg)
        Dim url As String = arg.Url
        Dim httpStatusCode As HttpStatusCode = arg.HttpStatus
        Return ShowHttpErrorPageResponse.Show("HTTP Error web page:" & httpStatusCode)
    End Function)

    

网络错误页面

      browser.Navigation.ShowNetErrorPageHandler = 
    new Handler<ShowNetErrorPageParameters, ShowNetErrorPageResponse>(arg =>
    {
        return ShowNetErrorPageResponse.Show("Network error web page");
    });

    

      browser.Navigation.ShowNetErrorPageHandler = 
    New Handler(Of ShowNetErrorPageParameters, ShowNetErrorPageResponse)(Function(arg)
        Return ShowNetErrorPageResponse.Show("Network error web page")
    End Function)

    

服务器提供的自定义错误页面不会被这些处理程序拦截，并且无法使用此功能进行覆盖。上述处理程序仅在覆盖 Chromium 默认错误页面时调用。

Go Top

介绍

安装

指南