Brows.Operations.Windows 1.7.0

dotnet add package Brows.Operations.Windows --version 1.7.0
                    
NuGet\Install-Package Brows.Operations.Windows -Version 1.7.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Brows.Operations.Windows" Version="1.7.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Brows.Operations.Windows" Version="1.7.0" />
                    
Directory.Packages.props
<PackageReference Include="Brows.Operations.Windows" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Brows.Operations.Windows --version 1.7.0
                    
#r "nuget: Brows.Operations.Windows, 1.7.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Brows.Operations.Windows@1.7.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Brows.Operations.Windows&version=1.7.0
                    
Install as a Cake Addin
#tool nuget:?package=Brows.Operations.Windows&version=1.7.0
                    
Install as a Cake Tool

Brows.Operations.Windows

WPF presentation for Brows.Operations. The package provides OperatorControl, which displays relevant root operations and their child hierarchy, progress, errors, and root-level Cancel or Remove commands.

Assign an operator created through the Composition package to the control's Operator property:

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:operations="clr-namespace:Brows.Windows.Controls;assembly=Brows.Operations.Windows">
  <operations:OperatorControl x:Name="OperationView" />
</Window>
// operatorFactory is resolved through Brows.Composition.
OperationView.Operator = operatorFactory.Create();

Set OperationItemsTemplate to choose the items control used for both root and child collections:

<operations:OperatorControl x:Name="OperationView">
  <operations:OperatorControl.OperationItemsTemplate>
    <DataTemplate>
      <ListBox ItemsSource="{Binding}" />
    </DataTemplate>
  </operations:OperatorControl.OperationItemsTemplate>
</operations:OperatorControl>

The template receives the collection source as its data context. Bind ItemsSource to it; the built-in operation row template remains available. A ListView can be used the same way. Leaving OperationItemsTemplate unset or setting it to null uses the default ItemsControl.

Set OperationErrorTemplate to customize how an operation's exception is displayed. The template receives the exception itself as its data context:

<operations:OperatorControl.OperationErrorTemplate>
  <DataTemplate>
    <TextBlock Text="{Binding Message}" Foreground="DarkRed" TextWrapping="Wrap" />
  </DataTemplate>
</operations:OperatorControl.OperationErrorTemplate>

Leaving OperationErrorTemplate unset or setting it to null uses the default message display.

Set OperationDisplay to Responsive to adapt the layout to the available width. The default value, Default, displays every value in its own column and scrolls horizontally when the columns do not fit.

<operations:OperatorControl x:Name="OperationView" OperationDisplay="Responsive" />

In Responsive mode, the layout matches Default while the columns fit in the width available to a root operation row: the operation list's viewport less any horizontal margin, padding, or border that OperationItemsTemplate adds around it, and limited by any Width or MaxWidth set within it. While an automatic vertical scrollbar is hidden, its width is still reserved. If a scroll template places the scrollbar over the content, the overlap is reserved while it is visible as well. Each root row uses the resulting width budget, so operations nested more deeply do not move its commands out of view. As the width decreases, the control:

  1. Collapses the progress bar. The progress bar requires the width that OperationProgressBarStyle gives it, resolved from Width, MinWidth, and MaxWidth as WPF layout does, plus its horizontal Margin. Without an explicit width or minimum width, it requires 100 device-independent pixels. In Responsive mode the control applies the style to one hidden progress bar, without an operation data context, to read these values. Sizing that depends on an operation's values, such as a trigger on progress, is not reflected. Space required by elements inside the progress bar's control template is not detected either; if a custom template needs a minimum width, also set it as MinWidth on the style.
  2. Shows the rate and average values beneath the other values.
  3. Shows the progress and target values beneath the other values as well, while the data remains in its column.
  4. Shows the data vertically beneath the operation name too, and hides the column headers. The name column then narrows as needed so that the Cancel and Remove commands remain in the viewport. Below the depth and command column widths (150 device-independent pixels by default), the remaining content is clipped or scrolled.

Errors are always shown beneath the operation in Responsive mode so that long messages can wrap. Values shown beneath the operation use their own templates, so column templates sized for the columns do not need to suit the vertical layout:

Property Template data context
OperationInlineHeaderTemplate Header text displayed beside each value.
OperationInlineDataContentTemplate Detail text.
OperationInlineProgressContentTemplate Progress display string.
OperationInlineProgressRateContentTemplate Formatted progress-rate string.
OperationInlineProgressRateAverageContentTemplate Formatted average progress-rate string.
OperationInlineTargetContentTemplate Target display string.

Leaving an inline template unset or setting it to null uses wrapping text. OperationErrorTemplate is used for errors in both modes.

The built-in Cancel and Remove commands capture their creating WPF dispatcher. CanExecuteChanged notifications run immediately when raised on that dispatcher; notifications raised on workers are queued asynchronously to it. The operator posts root and child collection changes asynchronously to the context captured when it was created. Create the operator on the WPF dispatcher or pass its context explicitly to IOperatorFactory.Create(SynchronizationContext).

You can call Operate, report progress, and register children from worker threads. The operation tree synchronizes state updates, while property-change notifications run on the updating thread; WPF bindings marshal bound property updates to the dispatcher. Direct event subscribers run on the updating thread after state locks have been released and the update's state has been committed. Reentrant reports append notifications to the current thread's batch. Creating the operator does not change delegate execution or normal await context capture. The project targets net462, net48, net8.0-windows, and net10.0-windows, and requires WPF. See the repository for the sample project and usage guidance.

Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible.  net9.0-windows was computed.  net10.0-windows was computed.  net10.0-windows7.0 is compatible. 
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.7.0 67 11/18/2026
1.6.0 96 11/13/2026
1.5.0 89 11/12/2026
1.4.0 90 11/11/2026
1.3.0 126 10/5/2026
1.2.0 119 10/3/2026
1.1.0 105 10/2/2026
1.0.0 104 10/2/2026