Connect ListBox Instances

Updated on Sep 3, 2026

One of the main benefits of the Telerik Blazor ListBox is the ability to move items from one component instance to another. This article explains how to link multiple ListBoxes to transfer items.

The ListBox component allows connecting unlimited number of instances. However, the connecting always works in pairs:

• There is one primary ListBox instance and one secondary.
• The primary ListBox is the one that shows toolbar buttons and fires OnTransfer events.
• The secondary ListBox can be primary to a third ListBox component, and so on.

Configuration

To connect ListBox components:

1. Set the Id parameter of all ListBox instances.
2. Set the ConnectedListBoxId parameter of the primary instance to the Id value of the secondary instance.
3. Hide the transfer buttons from the secondary instance, unless it's a primary one for another ListBox.
4. Subscribe to the OnTransfer event handler of all primary ListBoxes.
5. Rebind() each ListBox after making programmatic changes to its Data.

The object references in args.Items in the OnTransfer handler do not match the object references in the Data collection of the source ListBox. To remove items from the source ListBox, search for them by some unique identifier.

Example

Connect and move items between ListBoxes

Example

View Source

Loading ...

Next Steps

• Enable ListBox drag-and-drop
• Implement ListBox templates
• Handle ListBox events

See Also

• Live Demo: ListBox