Cefsharp ChromiumWebBrowser缺失LoadHtml()方法：WPF下如何传入HTML字符串

方法找不到的常见原因排查 #

• 确认项目已正确安装匹配目标平台架构的CefSharp.Wpf NuGet包，不要仅安装通用基础包CefSharp.Common，否则WPF端的扩展方法会缺失。
• 代码文件顶部必须引入using CefSharp;命名空间：早期版本的LoadHtml是ChromiumWebBrowser的直接实例方法，后续版本迭代将该方法迁移到了CefSharp.WebBrowserExtensions静态类下作为扩展方法，未引入对应命名空间时IDE会直接提示方法不存在。
• 确认CefSharp组件已完成初始化：只有在IsBrowserInitialized属性返回true之后，调用加载方法才会生效，组件未初始化时调用不会执行任何逻辑。

适配带图片、PDF资源的HTML加载实现 #

最新版的LoadHtml提供了两个重载，可根据实际场景选择：

• 纯在线资源场景：加载仅包含在线域名下的图片、PDF引用，无本地相对路径资源的格式化文本，直接调用无基地址参数的重载即可：

  browser.LoadHtml(你的HTML字符串内容);
  

  该重载默认以about:blank作为页面基地址，可正常加载受信的在线资源。
• 带本地资源场景：如果HTML中引用了项目内置的本地图片、本地PDF文件，必须使用带自定义基地址的重载，否则会被浏览器同源策略拦截，导致资源加载失败：

  browser.LoadHtml(你的HTML字符串内容, 自定义基地址);
  

  自定义基地址需要搭配CefSharp的自定义协议映射使用，将协议路径和项目的本地资源目录绑定，例如注册appresource://协议后，将所有该协议下的请求映射到项目输出目录的资源文件夹，此时传入的基地址设为appresource:///，HTML中编写的相对路径图片、PDF引用就可以被正常解析加载。

常见踩坑提示 #

• 所有对ChromiumWebBrowser的操作必须在WPF UI线程执行，跨线程调用会触发异常或加载无响应。
• 不要直接在窗体构造函数中调用加载逻辑，建议订阅IsBrowserInitializedChanged事件，等待组件完成初始化后再执行HTML加载，避免首次加载失败。
• CefSharp默认内置PDF渲染模块，只要资源路径解析正确，嵌入的PDF无需额外组件即可正常渲染预览。

内容的提问来源于stack exchange，提问作者SzakiII