WPF and C# Code Formatting

Applies consistent code style to XAML and C# files.

1. Required Tools

.NET 10 SDK

All commands use dotnet dnx for cross-platform compatibility (Windows, Linux, macOS).

Verify .NET 10 is available

dotnet --version # Should be 10.0.x or higher

XamlStyler (XAML Formatting)

Run via dotnet dnx (dotnet tool runner). No manual installation required.

dotnet format (C# Formatting)

Included with .NET SDK by default.

2. Configuration Files

Settings.XamlStyler

Copy from template to workspace root if Settings.XamlStyler doesn't exist.

Template location: templates/Settings.XamlStyler

Key settings:

• AttributesTolerance: 1

• Allow up to 1 attribute on same line

• KeepFirstAttributeOnSameLine: true

• Keep first attribute on element line

.editorconfig

Copy from template to workspace root if .editorconfig doesn't exist.

Template location: templates/.editorconfig

Key settings:

• Indentation: 4 spaces

• Line ending: CRLF (Windows)

• Max line length: 120

3. Formatting Commands

XAML Formatting

Format all XAML files in workspace

dotnet dnx -y XamlStyler.Console -- -d "{workspace}" -r -c "{workspace}/Settings.XamlStyler"

Format single file

dotnet dnx -y XamlStyler.Console -- -f "{file.xaml}" -c "{workspace}/Settings.XamlStyler"

dotnet dnx Options:

• -y : Auto-accept confirmation prompt

: Separator between dnx options and tool arguments

XamlStyler Options:

• -d : Target directory

• -f : Target file

• -r : Recursive processing

• -c : Configuration file path

C# Formatting

Format entire solution

dotnet format "{solution.sln}" --no-restore

Format specific project only

dotnet format "{project.csproj}" --no-restore

Format single file

dotnet format "{project.csproj}" --include "{file.cs}" --no-restore

Options:

• --no-restore : Skip NuGet restore (faster)

• --include : Target specific file

4. Workflow

Full Formatting

Task Progress:

• Step 1: Check if Settings.XamlStyler exists, create if not
• Step 2: Check if .editorconfig exists, create if not
• Step 3: Run dotnet dnx XamlStyler.Console for XAML formatting
• Step 4: Run dotnet format for C# formatting

Per-file Formatting (Hook Usage)

• When .xaml file modified: Run dotnet dnx XamlStyler.Console
• When .cs file modified: Run dotnet format

5. Notes

• Check git status: Verify uncommitted changes before formatting

• Binary exclusion: bin/, obj/ folders automatically excluded

• Encoding: UTF-8 with BOM maintained (Visual Studio compatible)

6. References

• XamlStyler GitHub

• dotnet format Documentation

• .editorconfig Specification