C++-Formatierungsoptionen

  • Artikel

Die Formatierungsoptionen in diesem Artikel gelten für C#-Code. Dies sind Optionen für die Codeformatregel IDE0055.

Optionen für „Neue Zeile“

Die Zeilenwechseloptionen betreffen die Verwendung von Zeilenumbrüchen zur Formatierung von Code.

EDITORCONFIG-Beispieldatei:

#  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 bezieht sich auf die Frage, ob eine öffnende geschweifte Klammer { in derselben Zeile wie der vorangehende Code oder in einer neuen Zeile platziert werden soll. Für diese Regel geben Sie Alle, Keine oder mindestens ein Codeelement an, wie z.B. Methoden oder Eigenschaften, um festzulegen, wann diese Regel angewendet werden soll. Um mehrere Codeelemente anzugeben, trennen Sie diese durch Komma (,).

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_before_open_brace
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte all Geschweifte Klammern müssen für alle Ausdrücke in einer neuen Zeile stehen („Allman“-Format).
none Geschweifte Klammern müssen für alle Ausdrücke in der gleichen Zeile stehen („K&R“).
accessors, anonymous_methods, anonymous_types, control_blocks, events, indexers,
lambdas, local_functions, methods, object_collection_array_initializers, properties, types		 Geschweifte Klammern müssen für das angegebene Codeelement in einer neuen Zeile stehen („Allman“-Format).
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_before_else
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true else-Anweisungen in einer neuen Zeile platzieren.
false else-Anweisungen in der gleichen Zeile platzieren.
Standardoptionswert true

Codebeispiele:

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

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

csharp_new_line_before_catch

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_before_catch
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true catch-Anweisungen in einer neuen Zeile platzieren.
false catch-Anweisungen in der gleichen Zeile platzieren.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_before_finally
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true finally-Anweisungen müssen nach der schließenden Klammer in einer neuen Zeile stehen.
false finally-Anweisungen müssen nach der schließenden Klammer in der gleichen Zeile stehen.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_before_members_in_object_initializers
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Member von Objektinitialisierern müssen in separaten Zeilen stehen
false Member von Objektinitialisierern müssen in der gleichen Zeile stehen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_before_members_in_anonymous_types
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Member von anonymen Typen müssen in separaten Zeilen stehen
false Member von anonymen Typen müssen in der gleichen Zeile stehen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_new_line_between_query_expression_clauses
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Elemente von Abfrageausdrucksklauseln müssen in separaten Zeilen stehen
false Elemente von Abfrageausdrucksklauseln müssen in der gleichen Zeile stehen
Standardoptionswert 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 beziehen sich auf die Verwendung des Einzugs zum Formatieren von Code.

EDITORCONFIG-Beispieldatei:

#  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

Eigenschaft Wert Beschreibung
Name der Option csharp_indent_case_contents
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true switch Case-Inhalte einrücken.
false switch Case-Inhalte nicht einrücken.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_indent_switch_labels
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true switch-Bezeichner einrücken
false switch-Bezeichner nicht einrücken
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_indent_labels
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte flush_left Bezeichnungen werden in der Spalte ganz links angeordnet
one_less_than_current Bezeichnungen werden mit geringerem Einzug platziert als der aktuelle Kontext.
no_change Bezeichnungen werden mit dem gleichen Einzug platziert wie der aktuelle Kontext.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_indent_block_contents
Gültige Sprachen C#
Optionswerte true Blockinhalte einziehen.
false Blockinhalte nicht einziehen.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_indent_braces
Gültige Sprachen C#
Optionswerte true Geschweifte Klammern einziehen.
false Geschweifte Klammern nicht einziehen.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_indent_case_contents_when_block
Gültige Sprachen C#
Optionswerte true Wenn es sich um einen Block handelt, ziehen Sie die Anweisungsliste und geschweifte Klammern für einen Fall in einer switch-Anweisung ein.
false Wenn es sich um einen Block handelt, ziehen Sie die Anweisungsliste und geschweifte Klammern für einen Fall in einer switch-Anweisung nicht ein.
Standardoptionswert 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 beziehen sich auf die Verwendung von Leerzeichen zur Codeformatierung.

EDITORCONFIG-Beispieldatei:

#  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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_after_cast
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen zwischen einer Umwandlung und dem Wert platzieren
false Leerzeichen zwischen einer Umwandlung und dem Wert entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_after_keywords_in_control_flow_statements
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen nach einem Schlüsselwort in einer Ablaufsteuerungsanweisung wie einer for-Schleife platzieren
false Leerzeichen nach einem Schlüsselwort in einer Ablaufsteuerungsanweisung wie einer for-Schleife entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_parentheses
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte control_flow_statements Leerzeichen zwischen Klammern von Ablaufsteuerungsanweisungen einfügen.
expressions Leerzeichen zwischen Klammern von Ausdrücken einfügen.
type_casts Leerzeichen zwischen Klammern in Typumwandlungen einfügen.
false (oder beliebiger anderer Wert) Fügen Sie nie Leerzeichen zwischen Klammern hinzu.

Wenn Sie diese Regel auslassen oder einen anderen Wert als control_flow_statements, expressions oder type_casts verwenden, wird die Einstellung nicht angewendet.

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
int y = (int)x;

csharp_space_before_colon_in_inheritance_clause

Eigenschaft Wert Beschreibung
Name der Option csharp_space_before_colon_in_inheritance_clause
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen vor dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration platzieren
false Leerzeichen vor dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_after_colon_in_inheritance_clause
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen nach dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration platzieren
false Leerzeichen nach dem Doppelpunkt für Basen oder Schnittstellen in einer Typdeklaration entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_around_binary_operators
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte before_and_after Leerzeichen vor und nach dem binären Operator einfügen
none Leerzeichen vor und nach dem binären Operator entfernen
ignore Leerzeichen um binäre Operatoren ignorieren
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_method_declaration_parameter_list_parentheses
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen nach der öffnenden Klammer und vor der schließenden Klammer einer Parameterliste der Methodendeklaration platzieren
false Leerzeichen nach der öffnenden Klammer und vor der schließenden Klammer einer Parameterliste der Methodendeklaration entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_method_declaration_empty_parameter_list_parentheses
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichnen bei einer Methodendeklaration innerhalb der Klammern für eine leere Parameterliste platzieren
false Leerzeichen bei einer Methodendeklaration innerhalb der Klammern für eine leere Parameterliste entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_method_declaration_name_and_open_parenthesis
Gültige Sprachen C#
Optionswerte true Leerzeichen zwischen dem Methodennamen und der öffnenden Klammer in der Methodendeklaration platzieren
false Leerzeichen zwischen dem Methodennamen und der öffnenden Klammer in der Methodendeklaration entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_method_call_parameter_list_parentheses
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen nach der öffnenden Klammer und vor der schließenden Klammer eines Methodenaufrufs platzieren
false Leerzeichen nach der öffnenden Klammer und vor der schließenden Klammer eines Methodenaufrufs entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_method_call_empty_parameter_list_parentheses
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen zwischen runden Klammern um leere Argumentliste einfügen
false Leerzeichen zwischen Klammern um leere Argumentliste entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_method_call_name_and_opening_parenthesis
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Leerzeichen zwischen dem Namen des Methodenaufrufs und der öffnenden Klammer einfügen
false Leerzeichen zwischen dem Namen des Methodenaufrufs und der öffnenden Klammer entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_after_comma
Gültige Sprachen C#
Optionswerte true Leerzeichen nach einem Komma einfügen
false Leerzeichen nach einem Komma entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_before_comma
Gültige Sprachen C#
Optionswerte true Leerzeichen vor einem Komma einfügen
false Leerzeichen vor einem Komma entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_after_dot
Gültige Sprachen C#
Optionswerte true Leerzeichen nach einem Punkt einfügen
false Leerzeichen nach einem Punkt entfernen
Standardoptionswert false

Codebeispiele:

// csharp_space_after_dot = true
this. Goo();

// csharp_space_after_dot = false
this.Goo();

csharp_space_before_dot

Eigenschaft Wert Beschreibung
Name der Option csharp_space_before_dot
Gültige Sprachen C#
Optionswerte true Leerzeichen vor einem Punkt einfügen
false Leerzeichen vor einem Punkt entfernen
Standardoptionswert false

Codebeispiele:

// csharp_space_before_dot = true
this .Goo();

// csharp_space_before_dot = false
this.Goo();

csharp_space_after_semicolon_in_for_statement

Eigenschaft Wert Beschreibung
Name der Option csharp_space_after_semicolon_in_for_statement
Gültige Sprachen C#
Optionswerte true Leerzeichen nach jedem Semikolon in einer for-Anweisung einfügen
false Leerzeichen nach jedem Semikolon in einer for-Anweisung entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_before_semicolon_in_for_statement
Gültige Sprachen C#
Optionswerte true Leerzeichen vor jedem Semikolon in einer for-Anweisung einfügen
false Leerzeichen vor jedem Semikolon in einer for-Anweisung entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_around_declaration_statements
Gültige Sprachen C#
Optionswerte ignore Zusätzliche Leerzeichen in Deklarationsanweisungen nicht entfernen
false Zusätzliche Leerzeichen in Deklarationsanweisungen entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_before_open_square_brackets
Gültige Sprachen C#
Optionswerte true Leerzeichen vor öffnenden eckigen Klammern [ einfügen
false Leerzeichen vor öffnenden eckigen Klammern [ entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_empty_square_brackets
Gültige Sprachen C#
Optionswerte true Leerzeichen zwischen leeren eckigen Klammern [ ] einfügen
false Leerzeichen zwischen leeren eckigen Klammern [] entfernen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_space_between_square_brackets
Gültige Sprachen C#
Optionswerte true Leerzeichen in nicht leeren eckigen Klammern [ 0 ] einfügen
false Leerzeichen aus nicht leeren eckigen Klammern [0] entfernen
Standardoptionswert false

Codebeispiele:

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

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

Umbruchoptionen

Die Umschließungs-Formatierungsoptionen beziehen sich auf die Verwendung von einzelnen Zeilen im Vergleich zu separaten Zeilen bei Anweisungen und Codeblöcken.

EDITORCONFIG-Beispieldatei:

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

csharp_preserve_single_line_statements

Eigenschaft Wert Beschreibung
Name der Option csharp_preserve_single_line_statements
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Anweisungen und Memberdeklarationen in der gleichen Zeile belassen.
false Anweisungen und Memberdeklarationen in verschiedenen Zeilen belassen.
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option csharp_preserve_single_line_blocks
Gültige Sprachen C#
Eingeführt in Version Visual Studio 2017
Optionswerte true Codeblock in einzelner Zeile belassen
false Codeblock in separaten Zeilen belassen
Standardoptionswert 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