Got a quick question? Discussions here on GitHub is the preferred place to ask!
CefSharp lets you embed Chromium in .NET apps. It is a lightweight .NET wrapper around the Chromium Embedded Framework (CEF) by Marshall A. Greenblatt. About 30% of the bindings are written in C++/CLI with the majority of code here is C#. It can be used from C# or VB, or any other CLR language. CefSharp provides both WPF and WinForms web browser control implementations.
CefSharp is BSD licensed, so it can be used in both proprietary and free/open source applications. For the full details, see the LICENSE file.
If you like and use CefSharp please consider signing up for a small monthly donation, even $25 can help tremendously. See Financial Support for more details.
Releases
Stable binaries are released on NuGet, and contain everything you need to embed Chromium in your .Net/CLR application. For usage see the Quick Start guide or checkout CefSharp.MinimalExample project for basic demos using the CefSharp NuGet packages.
- CefSharp.WinForms
- CefSharp.Wpf
- CefSharp.OffScreen
- CefSharp.Wpf.HwndHost (A HwndHost based WPF implementation, similar to hosting the WinForms version in WPF, supports data binding, airspace issues apply).
Documentation
- See the CefSharp.Wpf.Example or CefSharp.WinForms.Example projects for example web browsers built with CefSharp. They demo most of the available features.
- See the CefSharp.MinimalExample project for a basic demo of using the CefSharp NuGet packages.
- See the General Usage Guide in help getting started/dealing with common scenarios.
- See the Wiki for work-in-progress documentation
- See the FAQ for help with common issues
- Upgrading from an earlier version of CefSharp? See the ChangeLog for breaking changes and upgrade tips.
- CefSharp API generated from the source code comments.
Contact
Please keep the Issue Tracker for Bugs only please! Before submitting a PR please read CONTRIBUTING.
-
CefSharp Discussions is generally where
CefSharpspecific questions should be asked, please search before posting, thanks! - Stackoverflow is where generic html/javascript/C# questions can be asked.
- Chromium Embedded Framework(CEF) Forum
Branches & Forks
This is the official CefSharp fork, as maintained by the CefSharp community. You can also view the entire network of public forks/branches.
Development is done in the master branch. New features are preferably added in feature branches, if the changes are more than trivial. New PR's should be targeted against master.
When a new release is imminent a release branch is created. We try to avoid making public facing API changes in release branches (Adding new features is fine, just not breaking changes).
Releases
CI Builds
Every commit on master produces a Nuget package. Use at your own risk!
Pre-release
Stable
Release Branches
With each release a new branch is created, for example the 92.0.260 release corresponds to the cefsharp/92 branch.
If you're new to CefSharp and are downloading the source to check it out, please use a Release branch.
* VC++ 2019 is required starting with version 93
** For .Net Core Packages .Net Core 3.1 or .Net 5/6/7 are required.
| Branch | CEF Version | VC++ Version | .Net Version | Status |
|---|---|---|---|---|
| master | 5790 | 2019* | 4.6.2** | Development |
| cefsharp/115 | 5790 | 2019* | 4.6.2** | Release |
| cefsharp/114 | 5735 | 2019* | 4.5.2** | Unsupported |
| cefsharp/113 | 5615 | 2019* | 4.5.2** | Unsupported |
| cefsharp/112 | 5615 | 2019* | 4.5.2** | Unsupported |
| cefsharp/111 | 5563 | 2019* | 4.5.2** | Unsupported |
| cefsharp/110 | 5481 | 2019* | 4.5.2** | Unsupported |
| cefsharp/109 | 5414 | 2019* | 4.5.2** | Unsupported |
| cefsharp/108 | 5359 | 2019* | 4.5.2** | Unsupported |
| cefsharp/107 | 5304 | 2019* | 4.5.2** | Unsupported |
| cefsharp/106 | 5249 | 2019* | 4.5.2** | Unsupported |
| cefsharp/105 | 5195 | 2019* | 4.5.2** | Unsupported |
| cefsharp/104 | 5112 | 2019* | 4.5.2** | Unsupported |
| cefsharp/103 | 5060 | 2019* | 4.5.2** | Unsupported |
| cefsharp/102 | 5005 | 2019* | 4.5.2** | Unsupported |
| cefsharp/101 | 4951 | 2019* | 4.5.2** | Unsupported |
| cefsharp/100 | 4896 | 2019* | 4.5.2** | Unsupported |
| cefsharp/99 | 4844 | 2019* | 4.5.2** | Unsupported |
| cefsharp/98 | 4758 | 2019* | 4.5.2** | Unsupported |
| cefsharp/97 | 4692 | 2019* | 4.5.2** | Unsupported |
| cefsharp/96 | 4664 | 2019* | 4.5.2** | Unsupported |
| cefsharp/95 | 4638 | 2019* | 4.5.2** | Unsupported |
| cefsharp/94 | 4606 | 2019* | 4.5.2** | Unsupported |
| cefsharp/93 | 4577 | 2019* | 4.5.2** | Unsupported |
| cefsharp/92 | 4515 | 2015* | 4.5.2** | Unsupported |
| cefsharp/91 | 4472 | 2015* | 4.5.2** | Unsupported |
| cefsharp/90 | 4430 | 2015* | 4.5.2** | Unsupported |
| cefsharp/89 | 4389 | 2015* | 4.5.2** | Unsupported |
| cefsharp/88 | 4324 | 2015* | 4.5.2** | Unsupported |
| cefsharp/87 | 4280 | 2015* | 4.5.2** | Unsupported |
| cefsharp/86 | 4240 | 2015 | 4.5.2 | Unsupported |
| cefsharp/85 | 4183 | 2015 | 4.5.2 | Unsupported |
| cefsharp/84 | 4147 | 2015 | 4.5.2 | Unsupported |
| cefsharp/83 | 4103 | 2015 | 4.5.2 | Unsupported |
| cefsharp/81 | 4044 | 2015 | 4.5.2 | Unsupported |
| cefsharp/79 | 3945 | 2015 | 4.5.2 | Unsupported |
| cefsharp/77 | 3865 | 2015 | 4.5.2 | Unsupported |
| cefsharp/75 | 3770 | 2015 | 4.5.2 | Unsupported |
| cefsharp/73 | 3683 | 2015 | 4.5.2 | Unsupported |
| cefsharp/71 | 3578 | 2015 | 4.5.2 | Unsupported |
| cefsharp/69 | 3497 | 2015 | 4.5.2 | Unsupported |
| cefsharp/67 | 3396 | 2015 | 4.5.2 | Unsupported |
| cefsharp/65 | 3325 | 2015 | 4.5.2 | Unsupported |
| cefsharp/63 | 3239 | 2013 | 4.5.2 | Unsupported |
| cefsharp/62 | 3202 | 2013 | 4.5.2 | Unsupported |
| cefsharp/57 | 2987 | 2013 | 4.5.2 | Unsupported |
| cefsharp/55 | 2883 | 2013 | 4.5.2 | Unsupported |
| cefsharp/53 | 2785 | 2013 | 4.5.2 | Unsupported |
| cefsharp/51 | 2704 | 2013 | 4.5.2 | Unsupported |
| cefsharp/49 | 2623 | 2013 | 4.0 | Unsupported |
| cefsharp/47 | 2526 | 2013 | 4.0 | Unsupported |
| cefsharp/45 | 2454 | 2013 | 4.0 | Unsupported |
| cefsharp/43 | 2357 | 2012 | 4.0 | Unsupported |
| cefsharp/41 | 2272 | 2012 | 4.0 | Unsupported |
| cefsharp/39 | 2171 | 2012 | 4.0 | Unsupported |
| cefsharp/37 | 2062 | 2012 | 4.0 | Unsupported |
* VC++ 2019 is required starting with version 93
** For .Net Core Packages .Net Core 3.1/.Net 5.0 is required.
Financial Support
Is your company making money thanks to CefSharp? Do you rely on regular updates to the project? Alex Maitland needs your support! Signup to GitHub Sponsors.
One-Time or Recurring contributions can be made through GitHub Sponsors it only takes a GitHub account and a credit card. You can also make a One-Time contribution via PayPal.
As a stay at home dad I (@amaitland) rely on your contributions to help support my family.
Links
- CefGlue: An alternative .NET CEF wrapper built using P/Invoke.
- CEF GitHub Project : The official CEF issue tracker
- CEF Forum : The official CEF Forum
- CEF API Docs : Well worth a read if you are implementing a new feature
- CefSharp API Doc
Projects using CefSharp
- HtmlView : Visual Studio extension bringing CefSharp for showing HTML pages inside VS.
- SharpBrowser : The fastest web browser for C# with tabbed browsing and HTML5/CSS3.
- Chromely CefSharp : Build HTML Desktop Apps on .NET/.NET Core 3/.NET 5 using native GUI, HTML5/CSS.
项目简介
CefSharp 是一种将全功能符合标准的 Web 浏览器嵌入 C# 或 VB.NET 应用程序的简单方法。 CefSharp 具有用于 WinForms 和 WPF 应用程序的浏览器控件，以及用于自动化项目的无头（屏幕外）版本。 CefSharp 基于 Chromium Embedded Framework，即 Google Chrome 的开源版本。 CefSharp 采用现代 Web 标准，并支持 HTML5、JavaScript、CSS3 和 HTML5 音频/视频元素。 WebGL 支