Options de mise en forme de C#

Les options de formatage de cet article s'appliquent uniquement au code C#. Il s’agit d’options pour la règle de style code IDE0055.

Options de nouvelle ligne

Les options de nouvelle ligne concernent l'utilisation de nouvelles lignes pour formater le code.

• 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

Exemple de fichier .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

Cette option concerne le placement d'un accolade ouvrante { sur la même ligne que le code précédent ou sur une nouvelle ligne. Pour cette règle, vous spécifiez à la place all, none, ou un ou plusieurs éléments de code tels que methods ou proprerties, pour définir quand cette règle doit être appliquée. Pour spécifier plusieurs éléments de code, séparez-les par une virgule (,).

Property	Valeur	Description
Nom de l’option	csharp_new_line_before_open_brace
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	all	Les accolades doivent se trouver sur une nouvelle ligne pour toutes les expressions (style "Allman").
	none	- Les accolades doivent se trouver sur la même ligne pour toutes les expressions (« K&R »).
	accessors, anonymous_methods, anonymous_types, control_blocks, events, indexers, lambdas, local_functions, methods, object_collection_array_initializers, properties, types	Nécessiter la présence d’accolades sur une nouvelle ligne pour l’élément de code spécifié (style « Allman »).
Valeur d’option par défaut	all

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_new_line_before_else
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer les instructions else sur une nouvelle ligne.
	false	Placer les instructions else sur la même ligne.
Valeur d’option par défaut	true

Exemples de code :

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

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

csharp_new_line_before_catch

Property	Valeur	Description
Nom de l’option	csharp_new_line_before_catch
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer les instructions catch sur une nouvelle ligne.
	false	Placer les instructions catch sur la même ligne.
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_new_line_before_finally
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Les instructions finally doivent se trouver sur une nouvelle ligne après l’accolade fermante.
	false	Les instructions finally doivent se trouver sur la même ligne que l’accolade fermante.
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_new_line_before_members_in_object_initializers
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Les membres d’initialiseurs d’objet doivent être sur des lignes distinctes
	false	Les membres d’initialiseurs d’objet doivent être sur la même ligne
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_new_line_before_members_in_anonymous_types
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Les membres de types anonymes doivent être sur des lignes distinctes
	false	Les membres de types anonymes doivent être sur la même ligne
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_new_line_between_query_expression_clauses
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Les éléments des clauses d’expression de requête doivent se trouver sur des lignes distinctes
	false	Les éléments des clauses d’expression de requête doivent se trouver sur la même ligne
Valeur d’option par défaut	true

Exemples de code :

// 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;

Options d’indentation

Les options d'indentation concernent l'utilisation de l'indentation pour formater le code.

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

Exemple de fichier .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

Property	Valeur	Description
Nom de l’option	csharp_indent_case_contents
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Mettre en retrait le contenu de switch case
	false	Ne pas mettre en retrait le contenu de switch case
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_indent_switch_labels
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Mettre en retrait les étiquettes switch
	false	Ne pas mettre en retrait les étiquettes switch
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_indent_labels
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	flush_left	Les étiquettes sont positionnées au niveau de la colonne la plus à gauche
	one_less_than_current	Les étiquettes sont positionnées d’un retrait à gauche par rapport au contexte actuel
	no_change	Les étiquettes sont placées au même niveau de retrait que le contexte actuel
Valeur d’option par défaut	one_less_than_current

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_indent_block_contents
Langages applicables	C#
Valeurs d’option	true	Mettre en retrait le contenu d'un bloc.
	false	N'indentez pas le contenu des blocs.
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_indent_braces
Langages applicables	C#
Valeurs d’option	true	Indentez les accolades.
	false	N'indentez pas les accolades.
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_indent_case_contents_when_block
Langages applicables	C#
Valeurs d’option	true	Lorsqu'il s'agit d'un bloc, indentez la liste des instructions et les accolades pour un cas dans une instruction switch.
	false	Lorsqu'il s'agit d'un bloc, n'indentez pas la liste des instructions et les accolades pour un cas dans une instruction switch.
Valeur d’option par défaut	true

Exemples de code :

// 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;
}

Options d’espacement

Les options d'espacement concernent l'utilisation d'espaces pour formater le code.

• 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

Exemple de fichier .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

Property	Valeur	Description
Nom de l’option	csharp_space_after_cast
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer un espace entre un cast et la valeur
	false	Supprimer l’espace entre le cast et la valeur
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_after_keywords_in_control_flow_statements
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer un espace après un mot clé dans une instruction de flux de contrôle, par exemple une boucle for
	false	Supprimer l’espace après un mot clé dans une instruction de flux de contrôle, par exemple une boucle for
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_parentheses
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	control_flow_statements	Placer un espace entre les parenthèses d’instructions de flux de contrôle
	expressions	Placer un espace entre les parenthèses d’expressions
	type_casts	Placer un espace entre les parenthèses dans les casts de type
	false (ou toute autre valeur)	Préférez ne pas mettre d'espaces entre les parenthèses†
Valeur d’option par défaut	false†

† Si vous omettez cette règle ou utilisez une valeur autre que control_flow_statements, expressions ou type_casts, les espaces entre les parenthèses des instructions de contrôle de flux, des expressions et des transtypages sont supprimés.

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_before_colon_in_inheritance_clause
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer un espace avant le signe deux-points pour les bases ou les interfaces dans une déclaration de type
	false	Supprimer l’espace avant le signe deux-points pour les bases ou les interfaces dans une déclaration de type
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_after_colon_in_inheritance_clause
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer un espace après le signe deux-points pour les bases ou les interfaces dans une déclaration de type
	false	Supprimer l’espace après le signe deux-points pour les bases ou les interfaces dans une déclaration de type
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_around_binary_operators
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	before_and_after	Insérer un espace avant et après l’opérateur binaire
	none	Supprimer les espaces avant et après l’opérateur binaire
	ignore	Ignorer les espaces autour des opérateurs binaires
Valeur d’option par défaut	before_and_after

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_method_declaration_parameter_list_parentheses
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placez un espace après la parenthèse ouvrante et avant la parenthèse fermante d’une liste de paramètres de déclaration de méthode.
	false	Supprimer les espaces après la parenthèse ouvrante et avant la parenthèse fermante d’une liste de paramètres de déclaration de méthode
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_method_declaration_empty_parameter_list_parentheses
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Insérer un espace dans les parenthèses de liste de paramètres vides pour une déclaration de méthode
	false	Supprimer l’espace dans les parenthèses de liste de paramètres vides pour une déclaration de méthode
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_method_declaration_name_and_open_parenthesis
Langages applicables	C#
Valeurs d’option	true	Placer un espace entre le nom de la méthode et la parenthèse ouvrante dans la déclaration de méthode
	false	Supprimer les espaces entre le nom de la méthode et la parenthèse ouvrante dans la déclaration de méthode
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_method_call_parameter_list_parentheses
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Placer un caractère d’espacement après la parenthèse ouvrante et avant la parenthèse fermante d’un appel de méthode
	false	Supprimer les espaces après la parenthèse ouvrante et avant la parenthèse fermante d’un appel de méthode
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_method_call_empty_parameter_list_parentheses
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Insérer un espace dans les parenthèses de la liste d’arguments vide
	false	Supprimer un espace dans les parenthèses de la liste d’arguments vide
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_method_call_name_and_opening_parenthesis
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Insérer un espace entre le nom d’appel de méthode et la parenthèse ouvrante
	false	Supprimer l’espace entre le nom d’appel de méthode et la parenthèse ouvrante
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_after_comma
Langages applicables	C#
Valeurs d’option	true	Insérer un espace après une virgule
	false	Supprimer l’espace après une virgule
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_before_comma
Langages applicables	C#
Valeurs d’option	true	Insérer un espace avant une virgule
	false	Supprimer l’espace avant une virgule
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_after_dot
Langages applicables	C#
Valeurs d’option	true	Insérer un espace après un point
	false	Supprimer l’espace après un point
Valeur d’option par défaut	false

Exemples de code :

// csharp_space_after_dot = true
this. Goo();

// csharp_space_after_dot = false
this.Goo();

csharp_space_before_dot

Property	Valeur	Description
Nom de l’option	csharp_space_before_dot
Langages applicables	C#
Valeurs d’option	true	Insérer un espace avant un point
	false	Supprimer l’espace avant un point
Valeur d’option par défaut	false

Exemples de code :

// csharp_space_before_dot = true
this .Goo();

// csharp_space_before_dot = false
this.Goo();

csharp_space_after_semicolon_in_for_statement

Property	Valeur	Description
Nom de l’option	csharp_space_after_semicolon_in_for_statement
Langages applicables	C#
Valeurs d’option	true	Insérer un espace après chaque point-virgule dans une instruction for
	false	Supprimer l’espace après chaque point-virgule dans une instruction for
Valeur d’option par défaut	true

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_before_semicolon_in_for_statement
Langages applicables	C#
Valeurs d’option	true	Insérer un espace avant chaque point-virgule dans une instruction for
	false	Supprimer l’espace avant chaque point-virgule dans une instruction for
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_around_declaration_statements
Langages applicables	C#
Valeurs d’option	ignore	Ne pas supprimer les espaces supplémentaires dans les instructions de déclaration
	false	Supprimer les espaces supplémentaires dans les instructions de déclaration
Valeur d’option par défaut	false

Exemples de code :

// csharp_space_around_declaration_statements = ignore
int    x    =    0   ;

// csharp_space_around_declaration_statements = false
int x = 0;

csharp_space_before_open_square_brackets

Property	Valeur	Description
Nom de l’option	csharp_space_before_open_square_brackets
Langages applicables	C#
Valeurs d’option	true	Insérer un espace avant les crochets ouvrants [
	false	Supprimer l’espace avant les crochets ouvrants [
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_empty_square_brackets
Langages applicables	C#
Valeurs d’option	true	Insérer un espace entre les crochets vides [ ]
	false	Supprimer l’espace entre des crochets vides []
Valeur d’option par défaut	false

Exemples de code :

// 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

Property	Valeur	Description
Nom de l’option	csharp_space_between_square_brackets
Langages applicables	C#
Valeurs d’option	true	Insérer des espaces entre des crochets non vides [ 0 ]
	false	Supprimer des espaces entre des crochets non vides [0]
Valeur d’option par défaut	false

Exemples de code :

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

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

Options d’encapsulage

Les options de formatage de retour à la ligne concernent l'utilisation de lignes uniques par rapport à des lignes séparées pour les instructions et les blocs de code.

• csharp_preserve_single_line_statements
• csharp_preserve_single_line_blocks

Exemple de fichier .editorconfig :

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

csharp_preserve_single_line_statements

Property	Valeur	Description
Nom de l’option	csharp_preserve_single_line_statements
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Laisser les instructions et les déclarations de membre sur la même ligne
	false	Laisser les instructions et les déclarations de membre sur des lignes différentes
Valeur d’option par défaut	true

Exemples de code :

//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

Property	Valeur	Description
Nom de l’option	csharp_preserve_single_line_blocks
Langages applicables	C#
Version introduite	Visual Studio 2017
Valeurs d’option	true	Laisser le bloc de code sur une seule ligne
	false	Laisser le bloc de code sur des lignes distinctes
Valeur d’option par défaut	true

Exemples de code :

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

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

Voir aussi

• Règle de mise en forme (IDE0055)