Using directives

Sort system directives first

dotnet_sort_system_directives_first = true

Controls using directive groups. Using directives remain stable within System groups.

• Values: true false
• Default: true
• Applies to: Using directive groups.
• Guarantee: Using directives remain stable within System groups.

Input

using Zeta;
using System;

class Example { }

true (Default)

using Zeta;
using System;
using Zeta;

class Example { }

false

Code unchanged.

Separate import directive groups

dotnet_separate_import_directive_groups = false

Controls using directive groups. Only System and non-System group boundaries change.

• Values: true false
• Default: false
• Applies to: Using directive groups.
• Guarantee: Only System and non-System group boundaries change.

Input

using Zeta;
using System;

class Example { }

false (Default)

Code unchanged.

true

using Zeta;

using System;

class Example { }

Global using order

dress_global_using_order = first

Controls contiguous using directive runs. Directives and comments remain boundaries.

• Values: first last mixed
• Default: first
• Applies to: Contiguous using directive runs.
• Guarantee: Directives and comments remain boundaries.

Input

global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;

class Example { }

first (Default)

Code unchanged.

last

global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;
global using Alpha;

class Example { }

mixed

Code unchanged.

Using kind order

dress_using_kind_order = ordinary,static,alias

Controls contiguous using directive runs. Directives and comments remain boundaries.

• Values: ordinary static alias — every item, in any order, comma-separated.
• Default: ordinary,static,alias
• Applies to: Contiguous using directive runs.
• Guarantee: Directives and comments remain boundaries.

Input

global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;

class Example { }

ordinary,static,alias (Default)

Code unchanged.

ordinary,alias,static

global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;
using static System.Math;

class Example { }

static,ordinary,alias

using static System.Math;
global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;

class Example { }

static,alias,ordinary

global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;
global using Alpha;
using Zeta;

class Example { }

alias,ordinary,static

using Alias = System.String;
global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;

class Example { }

alias,static,ordinary

using Alias = System.String;
using static System.Math;
global using Alpha;
using Zeta;
using static System.Math;
using Alias = System.String;

class Example { }