Параметры форматирования C#

Параметры форматирования в этой статье применяются только к коду C#. Это варианты правила стиля кода IDE0055.

Параметры новой строки

Параметры новой строки касаются использования новых строк для форматирования кода.

• csharp_new_line_before_open_brace
• csharp_new_line_before_else
• csharp_new_line_before_catch
• csharp_new_line_before_finally
• csharp_new_line_before_members_in_object_initializers
• csharp_new_line_before_members_in_anonymous_types
• csharp_new_line_between_query_expression_clauses

Пример файла .editorconfig:

#  CSharp formatting rules:
[*.cs]
csharp_new_line_before_open_brace = methods, properties, control_blocks, types
csharp_new_line_before_else = true
csharp_new_line_before_catch = true
csharp_new_line_before_finally = true
csharp_new_line_before_members_in_object_initializers = true
csharp_new_line_before_members_in_anonymous_types = true
csharp_new_line_between_query_expression_clauses = true

csharp_new_line_before_open_brace

Этот параметр касается того, следует ли размещать открытые фигурные скобки { в той же строке, что и предыдущий код, или в новой строке. Для этого правила необходимо указать все, нетили один или несколько элементов кода, таких как методы или свойств, чтобы определить, когда это правило должно применяться. Чтобы указать несколько элементов кода, разделите их запятыми (,).

Свойство	Ценность	Описание
имя параметра	csharp_new_line_before_open_brace
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	all	Требовать, чтобы фигурные скобки были в новой строке для всех выражений (стиль Allman).
	none	Требовать, чтобы фигурные скобки были в одной строке для всех выражений ("K&R").
	accessors, anonymous_methods, anonymous_types, control_blocks, events, indexers, lambdas, local_functions, methods, object_collection_array_initializers, properties, types	Требовать, чтобы фигурные скобки были в новой строке для указанного элемента кода (стиль Allman).
значение параметра по умолчанию	all

Примеры кода:

// csharp_new_line_before_open_brace = all
void MyMethod()
{
    if (...)
    {
        ...
    }
}

// csharp_new_line_before_open_brace = none
void MyMethod() {
    if (...) {
        ...
    }
}

csharp_new_line_before_else

Свойство	Ценность	Описание
имя параметра	csharp_new_line_before_else
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите инструкции else в новую строку.
	false	Поместите операторы else в ту же строку.
значение параметра по умолчанию	true

Примеры кода:

// csharp_new_line_before_else = true
if (...) {
    ...
}
else {
    ...
}

// csharp_new_line_before_else = false
if (...) {
    ...
} else {
    ...
}

csharp_new_line_before_catch

Свойство	Ценность	Описание
имя параметра	csharp_new_line_before_catch
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите инструкции catch в новую строку.
	false	Поместите операторы catch в ту же строку.
значение параметра по умолчанию	true

Примеры кода:

// csharp_new_line_before_catch = true
try {
    ...
}
catch (Exception e) {
    ...
}

// csharp_new_line_before_catch = false
try {
    ...
} catch (Exception e) {
    ...
}

csharp_new_line_before_finally

Свойство	Ценность	Описание
имя параметра	csharp_new_line_before_finally
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Требовать, чтобы операторы finally были в новой строке после закрытия фигурной скобки.
	false	Требовать, чтобы операторы finally были в той же строке, что и закрывающая скобка.
значение параметра по умолчанию	true

Примеры кода:

// csharp_new_line_before_finally = true
try {
    ...
}
catch (Exception e) {
    ...
}
finally {
    ...
}

// csharp_new_line_before_finally = false
try {
    ...
} catch (Exception e) {
    ...
} finally {
    ...
}

csharp_new_line_before_members_in_object_initializers

Свойство	Ценность	Описание
имя параметра	csharp_new_line_before_members_in_object_initializers
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Требовать, чтобы члены инициализаторов объектов были в отдельных строках
	false	Требовать, чтобы члены инициализаторов объектов были в одной строке
значение параметра по умолчанию	true

Примеры кода:

// csharp_new_line_before_members_in_object_initializers = true
var z = new B()
{
    A = 3,
    B = 4
}

// csharp_new_line_before_members_in_object_initializers = false
var z = new B()
{
    A = 3, B = 4
}

csharp_new_line_before_members_in_anonymous_types

Свойство	Ценность	Описание
имя параметра	csharp_new_line_before_members_in_anonymous_types
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Требовать, чтобы члены анонимных типов были в отдельных строках
	false	Требовать, чтобы члены анонимных типов были в одной строке
значение параметра по умолчанию	true

Примеры кода:

// csharp_new_line_before_members_in_anonymous_types = true
var z = new
{
    A = 3,
    B = 4
}

// csharp_new_line_before_members_in_anonymous_types = false
var z = new
{
    A = 3, B = 4
}

csharp_new_line_between_query_expression_clauses

Свойство	Ценность	Описание
имя параметра	csharp_new_line_between_query_expression_clauses
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Требовать, чтобы элементы предложений выражений запроса были в отдельных строках
	false	Требовать, чтобы элементы предложений выражений запроса были в одной строке
значение параметра по умолчанию	true

Примеры кода:

// csharp_new_line_between_query_expression_clauses = true
var q = from a in e
        from b in e
        select a * b;

// csharp_new_line_between_query_expression_clauses = false
var q = from a in e from b in e
        select a * b;

Параметры отступа

Параметры отступа касаются использования отступа для форматирования кода.

• csharp_indent_case_contents
• csharp_indent_switch_labels
• csharp_indent_labels
• csharp_indent_block_contents
• csharp_indent_braces
• csharp_indent_case_contents_when_block

Пример файла .editorconfig:

#  CSharp formatting rules:
[*.cs]
csharp_indent_case_contents = true
csharp_indent_switch_labels = true
csharp_indent_labels = flush_left
csharp_indent_block_contents = true
csharp_indent_braces = false
csharp_indent_case_contents_when_block = true

csharp_indent_case_contents

Свойство	Ценность	Описание
имя параметра	csharp_indent_case_contents
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Отступ switch содержимое дела
	false	Не отступ switch содержимое дела
значение параметра по умолчанию	true

Примеры кода:

// csharp_indent_case_contents = true
switch(c) {
    case Color.Red:
        Console.WriteLine("The color is red");
        break;
    case Color.Blue:
        Console.WriteLine("The color is blue");
        break;
    default:
        Console.WriteLine("The color is unknown.");
        break;
}

// csharp_indent_case_contents = false
switch(c) {
    case Color.Red:
    Console.WriteLine("The color is red");
    break;
    case Color.Blue:
    Console.WriteLine("The color is blue");
    break;
    default:
    Console.WriteLine("The color is unknown.");
    break;
}

csharp_indent_switch_labels

Свойство	Ценность	Описание
имя параметра	csharp_indent_switch_labels
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Отступ switch метки
	false	Не отступы switch метки
значение параметра по умолчанию	true

Примеры кода:

// csharp_indent_switch_labels = true
switch(c) {
    case Color.Red:
        Console.WriteLine("The color is red");
        break;
    case Color.Blue:
        Console.WriteLine("The color is blue");
        break;
    default:
        Console.WriteLine("The color is unknown.");
        break;
}

// csharp_indent_switch_labels = false
switch(c) {
case Color.Red:
    Console.WriteLine("The color is red");
    break;
case Color.Blue:
    Console.WriteLine("The color is blue");
    break;
default:
    Console.WriteLine("The color is unknown.");
    break;
}

csharp_indent_labels

Свойство	Ценность	Описание
имя параметра	csharp_indent_labels
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	flush_left	Метки помещаются в самый левый столбец
	one_less_than_current	Метки помещаются в один меньшей отступ в текущий контекст
	no_change	Метки помещаются в тот же отступ, что и текущий контекст.
значение параметра по умолчанию	one_less_than_current

Примеры кода:

// csharp_indent_labels= flush_left
class C
{
    private string MyMethod(...)
    {
        if (...) {
            goto error;
        }
error:
        throw new Exception(...);
    }
}

// csharp_indent_labels = one_less_than_current
class C
{
    private string MyMethod(...)
    {
        if (...) {
            goto error;
        }
    error:
        throw new Exception(...);
    }
}

// csharp_indent_labels= no_change
class C
{
    private string MyMethod(...)
    {
        if (...) {
            goto error;
        }
        error:
        throw new Exception(...);
    }
}

csharp_indent_block_contents

Свойство	Ценность	Описание
имя параметра	csharp_indent_block_contents
применимые языки	C#
значения параметра	true	Отступ содержимого блока.
	false	Не отступ содержимого блока.
значение параметра по умолчанию	true

Примеры кода:

// csharp_indent_block_contents = true
static void Hello()
{
    Console.WriteLine("Hello");
}

// csharp_indent_block_contents = false
static void Hello()
{
Console.WriteLine("Hello");
}

csharp_indent_braces

Свойство	Ценность	Описание
имя параметра	csharp_indent_braces
применимые языки	C#
значения параметра	true	Отступ фигурные скобки.
	false	Не отступы фигурные скобки.
значение параметра по умолчанию	false

Примеры кода:

// csharp_indent_braces = true
static void Hello()
    {
    Console.WriteLine("Hello");
    }

// csharp_indent_braces = false
static void Hello()
{
    Console.WriteLine("Hello");
}

csharp_indent_case_contents_when_block

Свойство	Ценность	Описание
имя параметра	csharp_indent_case_contents_when_block
применимые языки	C#
значения параметра	true	Если это блок, отступ списка инструкций и фигурные скобки для дела в операторе switch.
	false	Если это блок, не отступьте список инструкций и фигурные скобки для дела в инструкции switch.
значение параметра по умолчанию	true

Примеры кода:

// csharp_indent_case_contents_when_block = true
case 0:
    {
        Console.WriteLine("Hello");
        break;
    }

// csharp_indent_case_contents_when_block = false
case 0:
{
    Console.WriteLine("Hello");
    break;
}

Параметры интервала

Параметры интервала касаются использования пробелов для форматирования кода.

• csharp_space_after_cast
• csharp_space_after_keywords_in_control_flow_statements
• csharp_space_between_parentheses
• csharp_space_before_colon_in_inheritance_clause
• csharp_space_after_colon_in_inheritance_clause
• csharp_space_around_binary_operators
• csharp_space_between_method_declaration_parameter_list_parentheses
• csharp_space_between_method_declaration_empty_parameter_list_parentheses
• csharp_space_between_method_declaration_name_and_open_parenthesis
• csharp_space_between_method_call_parameter_list_parentheses
• csharp_space_between_method_call_empty_parameter_list_parentheses
• csharp_space_between_method_call_name_and_opening_parenthesis
• csharp_space_after_comma
• csharp_space_before_comma
• csharp_space_after_dot
• csharp_space_before_dot
• csharp_space_after_semicolon_in_for_statement
• csharp_space_before_semicolon_in_for_statement
• csharp_space_around_declaration_statements
• csharp_space_before_open_square_brackets
• csharp_space_between_empty_square_brackets
• csharp_space_between_square_brackets

Пример файла .editorconfig:

#  CSharp formatting rules:
[*.cs]
csharp_space_after_cast = true
csharp_space_after_keywords_in_control_flow_statements = true
csharp_space_between_parentheses = control_flow_statements, type_casts
csharp_space_before_colon_in_inheritance_clause = true
csharp_space_after_colon_in_inheritance_clause = true
csharp_space_around_binary_operators = before_and_after
csharp_space_between_method_declaration_parameter_list_parentheses = true
csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
csharp_space_between_method_declaration_name_and_open_parenthesis = false
csharp_space_between_method_call_parameter_list_parentheses = true
csharp_space_between_method_call_empty_parameter_list_parentheses = false
csharp_space_between_method_call_name_and_opening_parenthesis = false
csharp_space_after_comma = true
csharp_space_before_comma = false
csharp_space_after_dot = false
csharp_space_before_dot = false
csharp_space_after_semicolon_in_for_statement = true
csharp_space_before_semicolon_in_for_statement = false
csharp_space_around_declaration_statements = false
csharp_space_before_open_square_brackets = false
csharp_space_between_empty_square_brackets = false
csharp_space_between_square_brackets = false

csharp_space_after_cast

Свойство	Ценность	Описание
имя параметра	csharp_space_after_cast
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите пробел между приведением и значением
	false	Удаление пространства между приведением и значением
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_after_cast = true
int y = (int) x;

// csharp_space_after_cast = false
int y = (int)x;

csharp_space_after_keywords_in_control_flow_statements

Свойство	Ценность	Описание
имя параметра	csharp_space_after_keywords_in_control_flow_statements
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите пробел после ключевого слова в оператор потока управления, например цикл for
	false	Удаление пространства после ключевого слова в инструкции потока управления, например цикла for
значение параметра по умолчанию	true

Примеры кода:

// csharp_space_after_keywords_in_control_flow_statements = true
for (int i;i<x;i++) { ... }

// csharp_space_after_keywords_in_control_flow_statements = false
for(int i;i<x;i++) { ... }

csharp_space_between_parentheses

Свойство	Ценность	Описание
имя параметра	csharp_space_between_parentheses
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	control_flow_statements	Поместите пространство между скобками операторов потока управления
	expressions	Поместите пространство между скобками выражений
	type_casts	Место между скобками в приведения типов
	false (или любое другое значение)	Предпочитать пробелы между скобками†
значение параметра по умолчанию	false†

†Если вы опустите это правило или используете любое значение, отличное от control_flow_statements, expressionsили type_casts, пробелы между операторами потока управления, выражениями и приведениями типов удаляются.

Примеры кода:

// csharp_space_between_parentheses = control_flow_statements
for ( int i = 0; i < 10; i++ ) { }

// csharp_space_between_parentheses = expressions
var z = ( x * y ) - ( ( y - x ) * 3 );

// csharp_space_between_parentheses = type_casts
int y = ( int )x;

// csharp_space_between_parentheses = false
for (int i = 0; i < 10; i++) { }
var z = (x * y) - ((y - x) * 3);
int y = (int)x;

csharp_space_before_colon_in_inheritance_clause

Свойство	Ценность	Описание
имя параметра	csharp_space_before_colon_in_inheritance_clause
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите пробел перед двоеточием для баз или интерфейсов в объявлении типа
	false	Удаление пространства перед двоеточием для баз или интерфейсов в объявлении типа
значение параметра по умолчанию	true

Примеры кода:

// csharp_space_before_colon_in_inheritance_clause = true
interface I
{

}

class C : I
{

}

// csharp_space_before_colon_in_inheritance_clause = false
interface I
{

}

class C: I
{

}

csharp_space_after_colon_in_inheritance_clause

Свойство	Ценность	Описание
имя параметра	csharp_space_after_colon_in_inheritance_clause
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите пробел после двоеточия для баз или интерфейсов в объявлении типа
	false	Удаление пространства после двоеточия для баз или интерфейсов в объявлении типа
значение параметра по умолчанию	true

Примеры кода:

// csharp_space_after_colon_in_inheritance_clause = true
interface I
{

}

class C : I
{

}

// csharp_space_after_colon_in_inheritance_clause = false
interface I
{

}

class C :I
{

}

csharp_space_around_binary_operators

Свойство	Ценность	Описание
имя параметра	csharp_space_around_binary_operators
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	before_and_after	Вставка пространства до и после двоичного оператора
	none	Удаление пробелов до и после двоичного оператора
	ignore	Игнорировать пробелы вокруг двоичных операторов
значение параметра по умолчанию	before_and_after

Примеры кода:

// csharp_space_around_binary_operators = before_and_after
return x * (x - y);

// csharp_space_around_binary_operators = none
return x*(x-y);

// csharp_space_around_binary_operators = ignore
return x  *  (x-y);

csharp_space_between_method_declaration_parameter_list_parentheses

Свойство	Ценность	Описание
имя параметра	csharp_space_between_method_declaration_parameter_list_parentheses
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите пробел после открывающей скобки и перед закрывающей скобкой списка параметров объявления метода
	false	Удалите пробелы после открывающей скобки и перед закрывающей скобкой списка параметров объявления метода
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_method_declaration_parameter_list_parentheses = true
void Bark( int x ) { ... }

// csharp_space_between_method_declaration_parameter_list_parentheses = false
void Bark(int x) { ... }

csharp_space_between_method_declaration_empty_parameter_list_parentheses

Свойство	Ценность	Описание
имя параметра	csharp_space_between_method_declaration_empty_parameter_list_parentheses
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Вставка пробела в пустые скобки списка параметров для объявления метода
	false	Удаление пространства в пустых скобках списка параметров для объявления метода
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_method_declaration_empty_parameter_list_parentheses = true
void Goo( )
{
    Goo(1);
}

void Goo(int x)
{
    Goo();
}

// csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
void Goo()
{
    Goo(1);
}

void Goo(int x)
{
    Goo();
}

csharp_space_between_method_declaration_name_and_open_parenthesis

Свойство	Ценность	Описание
имя параметра	csharp_space_between_method_declaration_name_and_open_parenthesis
применимые языки	C#
значения параметра	true	Поместите пробел между именем метода и открывающей скобкой в объявлении метода
	false	Удаление пробелов между именем метода и открытием скобки в объявлении метода
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_method_declaration_name_and_open_parenthesis = true
void M () { }

// csharp_space_between_method_declaration_name_and_open_parenthesis = false
void M() { }

csharp_space_between_method_call_parameter_list_parentheses

Свойство	Ценность	Описание
имя параметра	csharp_space_between_method_call_parameter_list_parentheses
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Поместите пробел после открывающей скобки и перед закрывающей скобкой вызова метода
	false	Удаление пробелов после открывающей скобки и перед закрывающей скобкой вызова метода
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_method_call_parameter_list_parentheses = true
MyMethod( argument );

// csharp_space_between_method_call_parameter_list_parentheses = false
MyMethod(argument);

csharp_space_between_method_call_empty_parameter_list_parentheses

Свойство	Ценность	Описание
имя параметра	csharp_space_between_method_call_empty_parameter_list_parentheses
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Вставка пробела в пустые скобки списка аргументов
	false	Удаление пространства в пустых скобках списка аргументов
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_method_call_empty_parameter_list_parentheses = true
void Goo()
{
    Goo(1);
}

void Goo(int x)
{
    Goo( );
}

// csharp_space_between_method_call_empty_parameter_list_parentheses = false
void Goo()
{
    Goo(1);
}

void Goo(int x)
{
    Goo();
}

csharp_space_between_method_call_name_and_opening_parenthesis

Свойство	Ценность	Описание
имя параметра	csharp_space_between_method_call_name_and_opening_parenthesis
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Вставка пробела между именем вызова метода и открытием скобки
	false	Удаление пространства между именем вызова метода и открытием скобки
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_method_call_name_and_opening_parenthesis = true
void Goo()
{
    Goo (1);
}

void Goo(int x)
{
    Goo ();
}

// csharp_space_between_method_call_name_and_opening_parenthesis = false
void Goo()
{
    Goo(1);
}

void Goo(int x)
{
    Goo();
}

csharp_space_after_comma

Свойство	Ценность	Описание
имя параметра	csharp_space_after_comma
применимые языки	C#
значения параметра	true	Вставка пробела после запятой
	false	Удаление места после запятой
значение параметра по умолчанию	true

Примеры кода:

// csharp_space_after_comma = true
int[] x = new int[] { 1, 2, 3, 4, 5 };

// csharp_space_after_comma = false
int[] x = new int[] { 1,2,3,4,5 };

csharp_space_before_comma

Свойство	Ценность	Описание
имя параметра	csharp_space_before_comma
применимые языки	C#
значения параметра	true	Вставка пробела перед запятой
	false	Удаление пространства перед запятой
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_before_comma = true
int[] x = new int[] { 1 , 2 , 3 , 4 , 5 };

// csharp_space_before_comma = false
int[] x = new int[] { 1, 2, 3, 4, 5 };

csharp_space_after_dot

Свойство	Ценность	Описание
имя параметра	csharp_space_after_dot
применимые языки	C#
значения параметра	true	Вставка пробела после точки
	false	Удаление пробела после точки
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_after_dot = true
this. Goo();

// csharp_space_after_dot = false
this.Goo();

csharp_space_before_dot

Свойство	Ценность	Описание
имя параметра	csharp_space_before_dot
применимые языки	C#
значения параметра	true	Вставка пробела перед точкой
	false	Удаление пробела перед точкой
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_before_dot = true
this .Goo();

// csharp_space_before_dot = false
this.Goo();

csharp_space_after_semicolon_in_for_statement

Свойство	Ценность	Описание
имя параметра	csharp_space_after_semicolon_in_for_statement
применимые языки	C#
значения параметра	true	Вставка пробела после каждой точки с запятой в операторе for
	false	Удаление пространства после каждой точки с запятой в операторе for
значение параметра по умолчанию	true

Примеры кода:

// csharp_space_after_semicolon_in_for_statement = true
for (int i = 0; i < x.Length; i++)

// csharp_space_after_semicolon_in_for_statement = false
for (int i = 0;i < x.Length;i++)

csharp_space_before_semicolon_in_for_statement

Свойство	Ценность	Описание
имя параметра	csharp_space_before_semicolon_in_for_statement
применимые языки	C#
значения параметра	true	Вставка пробела перед каждой точкой с запятой в операторе for
	false	Удаление пространства перед каждой точкой с запятой в инструкции for
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_before_semicolon_in_for_statement = true
for (int i = 0 ; i < x.Length ; i++)

// csharp_space_before_semicolon_in_for_statement = false
for (int i = 0; i < x.Length; i++)

csharp_space_around_declaration_statements

Свойство	Ценность	Описание
имя параметра	csharp_space_around_declaration_statements
применимые языки	C#
значения параметра	ignore	Не удаляйте лишние пробелы в операторах объявления
	false	Удаление дополнительных пробелов в операторах объявления
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_around_declaration_statements = ignore
int    x    =    0   ;

// csharp_space_around_declaration_statements = false
int x = 0;

csharp_space_before_open_square_brackets

Свойство	Ценность	Описание
имя параметра	csharp_space_before_open_square_brackets
применимые языки	C#
значения параметра	true	Вставка пробела перед открытием квадратных квадратных скобок [
	false	Удалите пространство перед открытием квадратных квадратных скобок [
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_before_open_square_brackets = true
int [] numbers = new int [] { 1, 2, 3, 4, 5 };

// csharp_space_before_open_square_brackets = false
int[] numbers = new int[] { 1, 2, 3, 4, 5 };

csharp_space_between_empty_square_brackets

Свойство	Ценность	Описание
имя параметра	csharp_space_between_empty_square_brackets
применимые языки	C#
значения параметра	true	Вставка пробела между пустыми квадратными скобками [ ]
	false	Удаление пространства между пустыми квадратными скобками []
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_empty_square_brackets = true
int[ ] numbers = new int[ ] { 1, 2, 3, 4, 5 };

// csharp_space_between_empty_square_brackets = false
int[] numbers = new int[] { 1, 2, 3, 4, 5 };

csharp_space_between_square_brackets

Свойство	Ценность	Описание
имя параметра	csharp_space_between_square_brackets
применимые языки	C#
значения параметра	true	Вставка пробелов в непустые квадратные скобки [ 0 ]
	false	Удаление пробелов в непустых квадратных скобках [0]
значение параметра по умолчанию	false

Примеры кода:

// csharp_space_between_square_brackets = true
int index = numbers[ 0 ];

// csharp_space_between_square_brackets = false
int index = numbers[0];

Параметры оболочки

Параметры форматирования оболочки касаются использования отдельных строк и отдельных строк для операторов и блоков кода.

• csharp_preserve_single_line_statements
• csharp_preserve_single_line_blocks

Пример файла .editorconfig:

#  CSharp formatting rules:
[*.cs]
csharp_preserve_single_line_statements = true
csharp_preserve_single_line_blocks = true

csharp_preserve_single_line_statements

Свойство	Ценность	Описание
имя параметра	csharp_preserve_single_line_statements
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Оставьте операторы и объявления членов в той же строке
	false	Оставьте операторы и объявления членов в разных строках
значение параметра по умолчанию	true

Примеры кода:

//csharp_preserve_single_line_statements = true
int i = 0; string name = "John";

//csharp_preserve_single_line_statements = false
int i = 0;
string name = "John";

csharp_preserve_single_line_blocks

Свойство	Ценность	Описание
имя параметра	csharp_preserve_single_line_blocks
применимые языки	C#
появилась версия	Visual Studio 2017
значения параметра	true	Оставьте блок кода в одной строке
	false	Оставьте блок кода в отдельных строках
значение параметра по умолчанию	true

Примеры кода:

//csharp_preserve_single_line_blocks = true
public int Foo { get; set; }

//csharp_preserve_single_line_blocks = false
public int MyProperty
{
    get; set;
}

См. также

• правила форматирования (IDE0055)