# Getting Started with WinForms BrowseEditor

This article shows how you can start using **RadBrowseEditor**.

## Adding Telerik Assemblies Using NuGet

To use `RadBrowseEditor` when working with NuGet packages, install the `Telerik.UI.for.WinForms.AllControls` package. The [package target framework version may vary](https://www.telerik.com/products/winforms/documentation/visual-studio-integration/available-nugets).

Read more about NuGet installation in the [Install using NuGet Packages](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/install-using-nuget) article.

> tip With the 2025 Q1 release, the Telerik UI for WinForms has a new licensing mechanism. You can learn more about it [here](https://www.telerik.com/products/winforms/documentation/licensing/license-key).

## Adding Assembly References Manually

When dragging and dropping a control from the Visual Studio (VS) Toolbox onto the Form Designer, VS automatically adds the necessary assemblies. However, if you're adding the control programmatically, you'll need to manually reference the following assemblies:

* **Telerik.Licensing.Runtime**
* **Telerik.WinControls**
* **Telerik.WinControls.UI**
* **TelerikCommon**

The Telerik UI for WinForms assemblies can be install by using one of the available [installation approaches](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/installing-on-your-computer).

## Defining the RadBrowseEditor

The following example demonstrates how to change the image of a **RadButton** using the **RadBrowseEditor**.

> caption Figure 1: Browsed Image

![WinForms RadBrowseEditor Browsed Image](https://www.telerik.com/products/winforms/documentation/assets/c1cfc0e1ba172bce00f81aa0ab3a8bee/editors-browse-editor-getting-started001.png)

1\. Drag a **RadBrowseEditor** and a **RadButton** on a form.

2\. Select the **RadButton** and in the **Property Window** set the **DisplayStyle** to **Image**

3\. Select the **RadBrowseEditor**, click the **Events tab** of the **Property Window**, locate the **ValueChanged** event and double-click it in order to create an event handler. Replace the event handler with the following code.

```C#
private void radBrowseEditor1_ValueChanged(object sender, EventArgs e)
{
    this.radButton1.Image = Image.FromFile(this.radBrowseEditor1.Value);
}
```

```VB.NET
Private Sub RadBrowseEditor1_ValueChanged(sender As Object, e As EventArgs)
    Me.RadButton1.Image = System.Drawing.Image.FromFile(Me.RadBrowseEditor1.Value)
End Sub
```

4\. Press **F5** to run the application. Press the browse button and select an image. The image is then applied to the **RadButton**.

## See Also

* [Structure](https://www.telerik.com/products/winforms/documentation/controls/editors/browseeditor/structure)
* [Smart Tag](https://www.telerik.com/products/winforms/documentation/controls/editors/browseeditor/design-time/smart-tag)
* [Dialog Types](https://www.telerik.com/products/winforms/documentation/controls/editors/browseeditor/dialog-types)

## Telerik UI for WinForms Learning Resources

* [Telerik UI for WinForms Browseeditor Component](https://www.telerik.com/products/winforms/browseeditor.aspx)
* [Getting Started with Telerik UI for WinForms Components](https://docs.telerik.com/devtools/winforms/getting-started/first-steps)
* [Telerik UI for WinForms Setup](https://docs.telerik.com/devtools/winforms/installation-and-upgrades/installing-on-your-computer)
* [Telerik UI for WinForms Converter](https://www.telerik.com/products/winforms/documentation/ai-coding-assistant/converter/converter)
* [Telerik UI for WinForms Visual Studio Templates](https://docs.telerik.com/devtools/winforms/visual-studio-integration/visual-studio-templates)
* [Deploy Telerik UI for WinForms Applications](https://docs.telerik.com/devtools/winforms/deployment-and-distribution/application-deployment)
* [Telerik UI for WinForms Virtual Classroom(Training Courses for Registered Users)](https://learn.telerik.com/learn/course/external/view/elearning/17/telerik-ui-for-winforms)
* [Telerik UI for WinForms License Agreement)](https://www.telerik.com/purchase/license-agreement/winforms-dlw-s)