C#Winform中WebBrowser控件的特性和详细调用方法 陀螺

该博客系转发自http://www.ityoudao.com/Web/Csharp_590_1779.html,感觉此文章讲的不错,遂转发和大家分享。

 

WebBrowser控件简介

WebBrowser控件由来以久,是一个ActiveX控件。以前可以通过COM引用并使用。但在.Net Framework 2.0以后,提供了WebBrowser控件的托管包装。托管包装使得在Windows窗体客户端中显示网页更为简便。

使用WebBrowser控件,可以模仿IE的功能进行Web访问,但不仅仅局限于此,还可以通过禁用默认的IE功能,从而将该控件用作简单的HTML文档查看器,甚至可以浏览office各种格式文档。

此外,WebBrowser支持DOM和文本两种方式修改其承载的内容。这一点意味着没有必要再把修改的HTML保存到临时文件,而是直接在内容中实现修改并显示,提高性能并节省临时文件资源消耗。

总而言之,我们可以通过种种方法,到达将Web控件和Windows窗体控件无缝地整合到一个应用程序中的目的。
利用WebBrowser浏览网页
浏览网页是WebBrowser的老本行,托管包装后的WebBrowser更加简便易用。主要几个方法如下:
Navigate(): 导航页面。与以前版本不同,可以只给定一个参数即可,即URI。
GoBack() / GoForward() / GoHome(): 向后/向前/回首页。 
Stop():Refresh(): 停止加载/刷新
以上几个主要方法是用于导航各个页面用的,但它们并不是永远生效。这些方法是否生效,取决于AllowNavigation属性,默认为true,允许导航。
Print():用于打印。

(1)WebBrowser中的Html文档模型

我们可以通过DOM或文本的形式返回当前WebBrowser中的HTML文档:
Document: DOM(文档对象模型)形式的对当前网页的HTML描述。
DocumentText: 文本形式的对当前网页的HTML描述。
DocumentStream: 流形式的HTML描述。
关于文本形式的没有什么好说的,它是最直接的HTML描述,但是难于动态修改,而相比之下DOM形式的HTML描述则灵活的多,可以任意添加、修改、删除任意节点。DOM对象模型主要元素有HtmlDocument, HtmlElement, HtmlNode, HtmlText等等,在此不再啰嗦了。

(2)WebBrowser与IE
默认情况下,WebBrowser控件功能于IE极其相似,提供基本功能。如:可以通过GoHome(),GoBack(),GoFoward(),Stop(),Refresh()来实现IE工具栏中的主页、向后、向前、停止、刷新;通过Navigate()来实现IE中的地址栏;通过设置IsWebBrowserContextMenuEnabled = true来实现IE右键菜单;通过设置WebBrowserShortcutsEnabled = true来实现IE的快捷键等等。
同样在某些特殊需要下,我们可能不希望WebBrowser的行为与IE一样,比如我们只是希望WebBrowser作为一个Html的显示器,在这种情况下可把AllowNavigate设置成false来阻止WebBrowser的导航功能;把IsWebBrowserContextMenuEnabled和WebBrowserShortcutsEnabled设置为false来阻止右键菜单和快捷键等等。从而阻止了WebBrowser的一些IE特性。

(3)WebBrowser中的脚本错误处理
当IE浏览器遇到时脚本错误,左下角会出现一个黄色图标,点击可以查看脚本错误的详细信息,并不会有弹出的错误信息框。但是WebBrowser控件则没有这么聪明,它会弹出错误信息框,使得程序显的很不友好,而且会让一些自动执行的程序暂停。虽然WebBrowser提供了ScriptErrorsSuppressed属性,经过尝试,结果是令人遗憾的,通过设置该属性可以解决部分问题,但不能彻底解决。在此探讨两种解决方案:一是通过截获WebBrowser.Document.Window.Error事件,并阻止WebBrowser继续处理错误来解决。如下:
//注册捕获控件的错误的处理事件

this.WebBrowser.Document.Window.Error +=
new HtmlElementErrorEventHandler(Window_Error);
//对错误进行处理
void Window_Error(object sender, HtmlElementErrorEventArgs e)
{
e.Handled = true; // 阻止其他地方继续处理
}

上面的方法可以解决大部分问题,但对于多个框架嵌套等等的情形还是不能很好的解决,于是只能自己动手封装一个MyWebBrowser了,然后用我们自己的MyWebBrowser来替代WebBrowser。如下:

public class MyWebBrowser : System.Windows.Forms.WebBrowser
{
private SHDocVw.IWebBrowser2 Iwb2; protected override void AttachInterfaces(object nativeActiveXObject)
{
Iwb2 = (SHDocVw.IWebBrowser2) nativeActiveXObject;
Iwb2.Silent = true;
base.AttachInterfaces(nativeActiveXObject);
}
protected override void DetachInterfaces()
{
Iwb2 = null;
base.DetachInterfaces();
}
}

这种方法能能很好的解决问题,其实使用过非托管WebBrowser的朋友肯定看出来了,实际上是通过引用SHDocVw绕过托管代码,直接SHDocVw.IWebBrowser2.Silent = true,最原始的也是最有效的。
利用WebBrowser访问Office文件

刚刚说过浏览网页是WebBrowser的老本行,那么除了本行外,其实他还可以搞点兼职。我们知道,在.Net窗体中是不提供嵌入Office文档OLE控件的,如果希望嵌Office文档的话,一个可能的解决方案就是使用WebBrowser控件。
其实在IE中就可以嵌入Office文档,所以WebBrowser具有此功力也很正常,但它带来的效果确实不错。操作也很简单:
this.webBrowser1.Navigate(strFileName);
只此一句,WebBrowser就会以嵌入的形式打开Office文档(Word, Excel, PowerPoint,...)了,效果如下图:

点击浏览下一页
点击浏览下一页

使用 WebBrowser 控件时的注意事项

1、在NET 2.0下的Webbrowser控件是对Webbrowser COM组件的不完全封装。所以,在简便的同时也会出现这样或那样的问题。简便也是有代价的。

2、WebBrowser控件异步浏览到文档。在调用Navigate()时,该调用会在文档完全加载之前将控制权返回给应用程序。如果打算为所包含的文档实现自动操作,则必须在DocumentCompleted事件在文档完成加载后发出通知。或是通过IsBusy来判断当前WebBrowser是否正忙于加载其他文档。
然而,通过实践,问题却不是这么简单。一般情况下,当ReadyState属性变成READYSTATE_COMPLETE时,Webbrowser控件会通过触发DocumentCompleted事件来指示网页加载完毕。但当加载的网页包含frame时,可能会多次触发该事件,所以不能简单地通过它来判断网页加载完毕。并非每个frame都对应了一个DocumentCompleted事件,只有触发了DownloadBegin事件的frame才会有相应的DocumentCompleted事件。另外,最外层的frame总是最后触发DocumentCompleted事件。那么怎么准确的判断页面加载完毕了呢,以下为一方案:

int counter = 0 ; // 计数器
private void webBrowser_Navigated(object sender,

WebBrowserNavigatedEventArgs e){
counter ++ ;
}
private void webBrowser_DocumentCompleted(object sender,

WebBrowserDocumentCompletedEventArgs e){
counter -- ;

if (counter == 0){
// 加载完毕 
}
}

3、在一个项目中有多个WebBrowser控件并且每个控件都加载相同类型的Office文档(全都是Word或全都是Excel)时,会出现多种问题。最常见的问题发生在Office命令栏上(命令栏会被禁用)。如果在同一个窗体上有两个WebBrowser控件,且两个控件都加载Word文档,那么只有一组工具栏会是活动的,另外一个则被禁用,无法使用。所以,建议一个项目只使用一个控件,并且一次只浏览到一个文档。

4、要清除WebBrowser控件中的当前内容,使用下面的代码浏览到默认空白页:

this.webBrowser1.Navigate("about:blank");
原文地址:https://www.cnblogs.com/xjt927/p/2688102.html