Wrapping

Maximum line length

max_line_length = 160

Sets the target line width used by auto layout preferences.

• Values: positive integer off
• Default: 160
• Applies to: File representation or shared layout settings.
• Guarantee: The configured value is applied by its owning formatter stage.
• Shown with: dress_arguments_layout = auto

Input

Call(firstArgument, secondArgument, thirdArgument);

160 (Default)

Code unchanged.

40

Call(firstArgument, secondArgument, thirdArgument);
Call(
    firstArgument,
    secondArgument,
    thirdArgument
);

60

Code unchanged.

off

Code unchanged.

Lists

Arguments layout

dress_arguments_layout = auto

Controls Arguments. Only whitespace owned by syntax wrapping changes. Auto puts each item in a multiline list on its own line and keeps fitting single-line lists compact.

• Values: always_single auto always_multi
• Default: auto
• Applies to: Arguments.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

Call(firstArgument, secondArgument, thirdArgument);

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

Call(firstArgument, secondArgument, thirdArgument);
Call(
    firstArgument,
    secondArgument,
    thirdArgument
);

Parameters layout

dress_parameters_layout = auto

Controls Parameters. Only whitespace owned by syntax wrapping changes. Auto puts each item in a multiline list on its own line and keeps fitting single-line lists compact.

• Values: always_single auto always_multi
• Default: auto
• Applies to: Parameters.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

class Example { void Run(int first, int second, int third) { } }

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

class Example { void Run(int first, int second, int third) { } }
class Example { void Run(
    int first,
    int second,
    int third
) { } }

Collection expressions layout

dress_collection_expressions_layout = auto

Controls CollectionExpressions. Only whitespace owned by syntax wrapping changes. Auto puts each item in a multiline list on its own line and keeps fitting single-line lists compact.

• Values: always_single auto always_multi
• Default: auto
• Applies to: CollectionExpressions.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

int[] values = [1, 2, 3];

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

int[] values = [1, 2, 3];
int[] values = [
    1,
    2,
    3
];

Base type lists layout

dress_base_type_lists_layout = auto

Controls BaseTypeLists. Only whitespace owned by syntax wrapping changes.

• Values: always_single auto always_multi
• Default: auto
• Applies to: BaseTypeLists.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

class Example : Base, IFirst, ISecond { }

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

class Example : Base, IFirst, ISecond { }
class Example
    : Base,
    IFirst,
    ISecond { }

Constraint clauses layout

dress_constraint_clauses_layout = auto

Controls ConstraintClauses. Only whitespace owned by syntax wrapping changes.

• Values: always_single auto always_multi
• Default: auto
• Applies to: ConstraintClauses.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

class Example<T, U> where T : class where U : new() { }

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

class Example<T, U> where T : class where U : new() { }
class Example<T, U>
    where T : class
    where U : new() { }

Attributes layout

dress_attributes_layout = auto

Controls Attributes. Only whitespace owned by syntax wrapping changes.

• Values: always_single auto always_multi
• Default: auto
• Applies to: Attributes.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

[First, Second, Third] class Example { }

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

[First, Second, Third] class Example { }
[
    First,
    Second,
    Third
] class Example { }

Closing delimiters

Arguments closing delimiter position

dress_arguments_closing_delimiter_position = after_last_item

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: after_last_item
• Applies to: The closing boundary of multiline Arguments.
• Guarantee: Single-line lists and item layout are unchanged.

Input

Call(
    first,
    second);

after_last_item (Default)

Code unchanged.

own_line

Call(
    first,
    second);
    second
);

Parameters closing delimiter position

dress_parameters_closing_delimiter_position = own_line

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: own_line
• Applies to: The closing boundary of multiline Parameters.
• Guarantee: Single-line lists and item layout are unchanged.

Input

class Example(
    int value)
{
}

own_line (Default)

class Example(
    int value)
    int value
)
{
}

after_last_item

Code unchanged.

Object initializer closing delimiter position

dress_object_initializer_closing_delimiter_position = unset

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: unset (the rule makes no change unless you set it)
• Applies to: The closing boundary of multiline ObjectInitializers.
• Guarantee: Single-line lists and item layout are unchanged.

Input

var value = new Example
{
    First = 1
};

after_last_item

var value = new Example
{
    First = 1
};
    First = 1 };

own_line

Code unchanged.

Collection initializer closing delimiter position

dress_collection_initializer_closing_delimiter_position = unset

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: unset (the rule makes no change unless you set it)
• Applies to: The closing boundary of multiline CollectionInitializers.
• Guarantee: Single-line lists and item layout are unchanged.

Input

var values = new List<int>
{
    1, 2
};

after_last_item

var values = new List<int>
{
    1, 2
};
    1, 2 };

own_line

Code unchanged.

Array initializer closing delimiter position

dress_array_initializer_closing_delimiter_position = unset

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: unset (the rule makes no change unless you set it)
• Applies to: The closing boundary of multiline ArrayInitializers.
• Guarantee: Single-line lists and item layout are unchanged.

Input

var values = new[]
{
    1, 2
};

after_last_item

var values = new[]
{
    1, 2
};
    1, 2 };

own_line

Code unchanged.

With initializer closing delimiter position

dress_with_initializer_closing_delimiter_position = unset

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: unset (the rule makes no change unless you set it)
• Applies to: The closing boundary of multiline WithInitializers.
• Guarantee: Single-line lists and item layout are unchanged.

Input

var value = original with
{
    First = 1
};

after_last_item

var value = original with
{
    First = 1
};
    First = 1 };

own_line

Code unchanged.

Collection expression closing delimiter position

dress_collection_expression_closing_delimiter_position = unset

Places a multiline list’s closing delimiter after the last item or on its own line, aligned with the opening line. Single-line lists are unchanged. Comments retain required line breaks.

• Values: after_last_item own_line
• Default: unset (the rule makes no change unless you set it)
• Applies to: The closing boundary of multiline CollectionExpressions.
• Guarantee: Single-line lists and item layout are unchanged.

Input

int[] values = [
    1, 2
];

after_last_item

int[] values = [
    1, 2
];
    1, 2];

own_line

Code unchanged.

Initializers

Object initializer layout

dress_object_initializer_layout = auto

Controls ObjectInitializers. Only whitespace owned by syntax wrapping changes.

• Values: compact auto expanded
• Default: auto
• Applies to: ObjectInitializers.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var value = new Example { First = 1, Second = 2 };

auto (Default)

Code unchanged.

compact

Code unchanged.

expanded

var value = new Example { First = 1, Second = 2 };
var value = new Example
{
    First = 1,
    Second = 2
};

Collection initializer layout

dress_collection_initializer_layout = auto

Controls CollectionInitializers. Only whitespace owned by syntax wrapping changes.

• Values: compact auto expanded
• Default: auto
• Applies to: CollectionInitializers.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var values = new List<int> { 1, 2, 3 };

auto (Default)

Code unchanged.

compact

Code unchanged.

expanded

var values = new List<int> { 1, 2, 3 };
var values = new List<int>
{
    1,
    2,
    3
};

Array initializer layout

dress_array_initializer_layout = auto

Controls ArrayInitializers. Only whitespace owned by syntax wrapping changes.

• Values: compact auto expanded
• Default: auto
• Applies to: ArrayInitializers.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var values = new[] { 1, 2, 3 };

auto (Default)

Code unchanged.

compact

Code unchanged.

expanded

var values = new[] { 1, 2, 3 };
var values = new[]
{
    1,
    2,
    3
};

With initializer layout

dress_with_initializer_layout = auto

Controls WithInitializers. Only whitespace owned by syntax wrapping changes.

• Values: compact auto expanded
• Default: auto
• Applies to: WithInitializers.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var value = original with { First = 1, Second = 2 };

auto (Default)

Code unchanged.

compact

Code unchanged.

expanded

var value = original with { First = 1, Second = 2 };
var value = original with
{
    First = 1,
    Second = 2
};

Expressions

Member access chains layout

dress_member_access_chains_layout = auto

Controls MemberAccessChains. Only whitespace owned by syntax wrapping changes.

• Values: always_single auto always_multi
• Default: auto
• Applies to: MemberAccessChains.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var value = source.Where(predicate).Select(selector).ToList();

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

var value = source.Where(predicate).Select(selector).ToList();
var value = source
    .Where(predicate)
    .Select(selector)
    .ToList();

Binary expressions layout

dress_binary_expressions_layout = auto

Controls BinaryExpressions. Only whitespace owned by syntax wrapping changes.

• Values: always_single auto always_multi
• Default: auto
• Applies to: BinaryExpressions.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var value = first + second + third;

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

var value = first + second + third;
var value = first
    + second
    + third;

Binary expression indentation

dress_binary_expression_indentation = precedence

Controls whether wrapped higher-precedence binary groups align with the outer expression or indent one additional level per precedence group. Does not introduce wrapping.

• Values: flat precedence
• Default: precedence
• Applies to: Wrapped binary expression indentation.
• Guarantee: Only whitespace changes.

Input

var result = first
    || second
        && third;

precedence (Default)

Code unchanged.

flat

var result = first
    || second
        && third;
    && third;

Conditional expressions layout

dress_conditional_expressions_layout = auto

Controls ConditionalExpressions. Only whitespace owned by syntax wrapping changes. Wrapped branches indent one level beyond the deepest formatted line of a multiline condition.

• Values: always_single auto always_multi
• Default: auto
• Applies to: ConditionalExpressions.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var value = condition ? first : second;

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

var value = condition ? first : second;
var value = condition
    ? first
    : second;

Nested ternary style

dress_nested_conditional_style = decision_ladder

Shapes wrapped nested ternaries. Decision ladders flatten false-branch chains; multiline conditions or branches fall back to staircase. Does not force single-line expressions to wrap.

• Values: flat staircase decision_ladder
• Default: decision_ladder
• Applies to: Nested conditional expression whitespace.
• Guarantee: Only whitespace changes.

Input

var result = first
    ? one
    : second
        ? two
        : three;

decision_ladder (Default)

var result = first
    ? one
    : second
        ? two
        : three;
var result = first ? one
    : second ? two
    : three;

flat

var result = first
    ? one
    : second
        ? two
        : three;
    ? two
    : three;

staircase

Code unchanged.

Operator position

dotnet_style_operator_placement_when_wrapping = beginning_of_line

Places wrapped binary and ternary operators at the beginning or end of the line. Does not introduce wrapping in single-line expressions. Commented operator boundaries are preserved.

• Values: beginning_of_line end_of_line
• Default: beginning_of_line
• Applies to: Binary and conditional operator whitespace.
• Guarantee: Only whitespace changes.

Input

var result = first
    + second
    + third;

beginning_of_line (Default)

Code unchanged.

end_of_line

var result = first
    + second
    + third;
var result = first +
    second +
    third;

Query clauses layout

dress_query_clauses_layout = auto

Controls QueryClauses. Only whitespace owned by syntax wrapping changes.

• Values: always_single auto always_multi
• Default: auto
• Applies to: QueryClauses.
• Guarantee: Only whitespace owned by syntax wrapping changes.

Input

var result = from item in items where item.Active select item.Name;

auto (Default)

Code unchanged.

always_single

Code unchanged.

always_multi

var result = from item in items where item.Active select item.Name;
var result = from item in items
    where item.Active
    select item.Name;