Freigeben über

C#-Formatierungsoptionen

  • Artikel

Die Formatierungsoptionen in diesem Artikel gelten nur für C#-Code. Dies sind Optionen für Codeformat-Regel-IDE0055.

Optionen für neue Linien

Die neuen Zeilenoptionen betreffen die Verwendung neuer Zeilen zum Formatieren von Code.

Beispiel .editorconfig Datei:

#  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

Diese Option betrifft, ob eine geöffnete geschweifte { in derselben Zeile wie der vorherige Code oder in einer neuen Zeile platziert werden soll. Für diese Regel geben Sie alle, keineoder ein oder mehrere Codeelemente wie Methoden oder Eigenschaftenan, um zu definieren, wann diese Regel angewendet werden soll. Wenn Sie mehrere Codeelemente angeben möchten, trennen Sie sie durch ein Komma (,).

Eigentum Wert Beschreibung
Optionsname csharp_new_line_before_open_brace
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte all Für alle Ausdrücke ("Allman"-Formatvorlage müssen geschweifte Klammern in einer neuen Zeile stehen).
none Für alle Ausdrücke ("K&R") müssen sich geschweifte Klammern in derselben Zeile befinden.
accessors, anonymous_methods, anonymous_types, control_blocks, events, indexers,
lambdas, local_functions, methods, object_collection_array_initializers, properties, types		 Festlegen, dass geschweifte Klammern in einer neuen Zeile für das angegebene Codeelement ("Allman"-Format) stehen.
Standardwert all

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_new_line_before_else
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren Sie else Anweisungen in einer neuen Zeile.
false Platzieren Sie else Anweisungen in derselben Zeile.
Standardwert true

Codebeispiele:

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

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

csharp_new_line_before_catch

Eigentum Wert Beschreibung
Optionsname csharp_new_line_before_catch
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren Sie catch Anweisungen in einer neuen Zeile.
false Platzieren Sie catch Anweisungen in derselben Zeile.
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_new_line_before_finally
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Erfordert, dass finally Anweisungen in einer neuen Zeile nach der schließenden Klammer stehen.
false Erfordert, dass sich finally Anweisungen in derselben Zeile wie die schließende geschweifte Klammer befinden.
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_new_line_before_members_in_object_initializers
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Elemente von Objektinitialisierern müssen in separaten Zeilen verwendet werden.
false Elemente von Objektinitialisierern müssen sich in derselben Zeile befinden
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_new_line_before_members_in_anonymous_types
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Anfordern von Mitgliedern anonymer Typen für separate Zeilen
false Festlegen, dass Mitglieder anonymer Typen in derselben Zeile vorhanden sind
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_new_line_between_query_expression_clauses
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Erfordern, dass Elemente von Abfrageausdrucksklauseln in separaten Zeilen enthalten sind
false Erfordern, dass Elemente von Abfrageausdrucksklauseln in derselben Zeile enthalten sind
Standardwert true

Codebeispiele:

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

Einzugsoptionen

Die Einzugsoptionen betreffen die Verwendung des Einzugs zum Formatieren von Code.

Beispiel .editorconfig Datei:

#  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

Eigentum Wert Beschreibung
Optionsname csharp_indent_case_contents
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Einzug switch Fallinhalt
false switch Fallinhalte nicht einziehen
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_indent_switch_labels
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Einrücken switch Bezeichnungen
false Beschriftungen nicht ein switch ziehen
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_indent_labels
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte flush_left Beschriftungen werden in der Spalte ganz links platziert.
one_less_than_current Beschriftungen werden in einem weniger Einzug in den aktuellen Kontext platziert.
no_change Beschriftungen werden im gleichen Einzug wie der aktuelle Kontext platziert.
Standardwert one_less_than_current

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_indent_block_contents
Anwendbare Sprachen C#
Optionswerte true Einzugsblockinhalte.
false Blockinhalte nicht einziehen.
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_indent_braces
Anwendbare Sprachen C#
Optionswerte true Geschweifte geschweifte Klammern einziehen.
false Nicht geschweifte geschweifte Klammern einziehen.
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_indent_case_contents_when_block
Anwendbare Sprachen C#
Optionswerte true Wenn es sich um einen Block handelt, nehmen Sie die Anweisungsliste und geschweifte Klammern für einen Fall in einer Switch-Anweisung ein.
false Wenn es sich um einen Block handelt, entfernen Sie nicht die Anweisungsliste und geschweifte Klammern für einen Fall in einer Switch-Anweisung.
Standardwert true

Codebeispiele:

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

Abstandsoptionen

Die Abstandsoptionen betreffen die Verwendung von Leerzeichen zum Formatieren von Code.

Beispiel .editorconfig Datei:

#  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

Eigentum Wert Beschreibung
Optionsname csharp_space_after_cast
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren eines Leerzeichens zwischen einer Umwandlung und dem Wert
false Entfernen des Abstands zwischen der Umwandlung und dem Wert
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_after_keywords_in_control_flow_statements
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren eines Leerzeichens nach einem Schlüsselwort in einer Steuerelementfluss-Anweisung, z. B. einer for Schleife
false Entfernen des Leerzeichens nach einem Schlüsselwort in einer Steuerelementfluss-Anweisung, z. B. einer for Schleife
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_parentheses
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte control_flow_statements Platzieren des Abstands zwischen Klammern von Ablaufsteuerungsanweisungen
expressions Platz zwischen Klammern von Ausdrücken platzieren
type_casts Platzieren des Abstands zwischen Klammern in Typ casts
false (oder einen anderen Wert) Bevorzugen Sie keine Leerzeichen zwischen Klammern†
Standardwert false†

†Wenn Sie diese Regel weglassen oder einen anderen Wert als control_flow_statements, expressionsoder type_castsverwenden, werden Leerzeichen zwischen Klammern von Steuerelementflussanweisungen, Ausdrücken und Typ casts entfernt.

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_before_colon_in_inheritance_clause
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren eines Leerzeichens vor dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration
false Entfernen des Leerzeichens vor dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_after_colon_in_inheritance_clause
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren eines Leerzeichens nach dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration
false Entfernen des Leerzeichens nach dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_around_binary_operators
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte before_and_after Einfügen von Leerzeichen vor und nach dem binären Operator
none Entfernen von Leerzeichen vor und nach dem binären Operator
ignore Ignorieren von Leerzeichen um binäre Operatoren
Standardwert before_and_after

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_method_declaration_parameter_list_parentheses
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren eines Leerzeichens nach der öffnenden Klammer und vor der schließenden Klammer einer Methodendeklarationsparameterliste
false Entfernen von Leerzeichen nach der öffnenden Klammer und vor der schließenden Klammer einer Methodendeklarationsparameterliste
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_method_declaration_empty_parameter_list_parentheses
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Einfügen von Leerraum in leere Parameterlistenklammern für eine Methodendeklaration
false Entfernen des Leerraums in leeren Parameterlistenklammern für eine Methodendeklaration
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_method_declaration_name_and_open_parenthesis
Anwendbare Sprachen C#
Optionswerte true Platzieren eines Leerzeichens zwischen dem Methodennamen und der öffnenden Klammer in der Methodendeklaration
false Entfernen von Leerzeichen zwischen dem Methodennamen und öffnender Klammer in der Methodendeklaration
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_method_call_parameter_list_parentheses
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Platzieren eines Leerzeichens nach der öffnenden Klammer und vor der schließenden Klammer eines Methodenaufrufs
false Entfernen von Leerzeichen nach der öffnenden Klammer und vor der schließenden Klammer eines Methodenaufrufs
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_method_call_empty_parameter_list_parentheses
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Einfügen von Leerzeichen in leere Argumentlistenklammern
false Entfernen des Leerraums in leeren Argumentlistenklammern
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_method_call_name_and_opening_parenthesis
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Einfügen des Leerzeichens zwischen Methodenaufrufname und öffnender Klammer
false Entfernen des Leerzeichens zwischen Methodenaufrufname und öffnender Klammer
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_after_comma
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen nach einem Komma
false Entfernen des Leerzeichens nach einem Komma
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_before_comma
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen vor einem Komma
false Entfernen des Leerzeichens vor einem Komma
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_after_dot
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen nach einem Punkt
false Entfernen des Leerzeichens nach einem Punkt
Standardwert false

Codebeispiele:

// csharp_space_after_dot = true
this. Goo();

// csharp_space_after_dot = false
this.Goo();

csharp_space_before_dot

Eigentum Wert Beschreibung
Optionsname csharp_space_before_dot
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen vor einem Punkt
false Entfernen des Leerzeichens vor einem Punkt
Standardwert false

Codebeispiele:

// csharp_space_before_dot = true
this .Goo();

// csharp_space_before_dot = false
this.Goo();

csharp_space_after_semicolon_in_for_statement

Eigentum Wert Beschreibung
Optionsname csharp_space_after_semicolon_in_for_statement
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen nach jedem Semikolon in einer for-Anweisung
false Entfernen des Leerzeichens nach jedem Semikolon in einer for-Anweisung
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_before_semicolon_in_for_statement
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen vor jedem Semikolon in einer for-Anweisung
false Entfernen des Leerzeichens vor jedem Semikolon in einer for-Anweisung
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_around_declaration_statements
Anwendbare Sprachen C#
Optionswerte ignore Entfernen von zusätzlichen Leerzeichen in Deklarationsanweisungen nicht
false Entfernen zusätzlicher Leerzeichen in Deklarationsanweisungen
Standardwert false

Codebeispiele:

// csharp_space_around_declaration_statements = ignore
int    x    =    0   ;

// csharp_space_around_declaration_statements = false
int x = 0;

csharp_space_before_open_square_brackets

Eigentum Wert Beschreibung
Optionsname csharp_space_before_open_square_brackets
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen vor dem Öffnen von eckigen Klammern [
false Entfernen des Leerzeichens vor dem Öffnen von eckigen Klammern [
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_empty_square_brackets
Anwendbare Sprachen C#
Optionswerte true Einfügen des Leerraums zwischen leeren eckigen Klammern [ ]
false Entfernen des Abstands zwischen leeren eckigen Klammern []
Standardwert false

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_space_between_square_brackets
Anwendbare Sprachen C#
Optionswerte true Einfügen von Leerzeichen in nicht leere eckige Klammern [ 0 ]
false Entfernen von Leerzeichen in nicht leeren eckigen Klammern [0]
Standardwert false

Codebeispiele:

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

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

Umbruchoptionen

Die Umbruchformatierungsoptionen betreffen die Verwendung einzelner Zeilen im Vergleich zu separaten Zeilen für Anweisungen und Codeblöcke.

Beispiel .editorconfig Datei:

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

csharp_preserve_single_line_statements

Eigentum Wert Beschreibung
Optionsname csharp_preserve_single_line_statements
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Verlassen von Anweisungen und Memberdeklarationen in derselben Zeile
false Verlassen von Anweisungen und Memberdeklarationen in verschiedenen Zeilen
Standardwert true

Codebeispiele:

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

Eigentum Wert Beschreibung
Optionsname csharp_preserve_single_line_blocks
Anwendbare Sprachen C#
Eingeführte Version Visual Studio 2017
Optionswerte true Codeblock in einzelner Zeile verlassen
false Codeblock in separaten Zeilen belassen
Standardwert true

Codebeispiele:

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

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

Siehe auch