Udostępnij za pośrednictwem

Opcje formatowania języka C#

  • Artykuł

Opcje formatowania w tym artykule dotyczą tylko kodu w języku C#. Są to opcje reguły stylu kodu IDE0055.

Opcje nowego wiersza

Opcje nowego wiersza dotyczą używania nowych wierszy do formatowania kodu.

Przykładowy plik .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

Ta opcja dotyczy tego, czy otwarty nawias klamrowy { powinien zostać umieszczony w tym samym wierszu co poprzedni kod, czy w nowym wierszu. Dla tej reguły należy określić wszystkich, braklub co najmniej jeden element kodu, taki jak metody lub właściwości , do zdefiniowania, kiedy ta reguła ma być stosowana. Aby określić wiele elementów kodu, rozdziel je przecinkiem (,).

Własność Wartość Opis
nazwa opcji csharp_new_line_before_open_brace
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji all Wymagaj, aby nawiasy klamrowe znajdowały się w nowym wierszu dla wszystkich wyrażeń ("Styl Allmana").
none Wymagaj, aby nawiasy klamrowe znajdowały się w tym samym wierszu dla wszystkich wyrażeń ("K&R").
accessors, anonymous_methods, anonymous_types, control_blocks, events, indexers,
lambdas, local_functions, methods, object_collection_array_initializers, properties, types		 Wymagaj, aby nawiasy klamrowe znajdowały się w nowym wierszu dla określonego elementu kodu ("Allman" style).
domyślna wartość opcji all

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_new_line_before_else
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść instrukcje else w nowym wierszu.
false Umieść instrukcje else w tym samym wierszu.
domyślna wartość opcji true

Przykłady kodu:

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

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

csharp_new_line_before_catch

Własność Wartość Opis
nazwa opcji csharp_new_line_before_catch
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść instrukcje catch w nowym wierszu.
false Umieść instrukcje catch w tym samym wierszu.
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_new_line_before_finally
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wymagaj finally instrukcji, aby znajdować się w nowym wierszu po zamykającym nawiasie klamrowym.
false Wymagaj, aby instrukcje finally znajdowały się w tym samym wierszu co zamykający nawias klamrowy.
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_new_line_before_members_in_object_initializers
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wymagaj, aby elementy członkowskie inicjatorów obiektów znajdowały się w osobnych wierszach
false Wymagaj, aby elementy członkowskie inicjatorów obiektów znajdowały się w tym samym wierszu
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_new_line_before_members_in_anonymous_types
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wymagaj, aby członkowie anonimowych typów znajdowali się w osobnych wierszach
false Wymagaj, aby członkowie typów anonimowych znajdowali się w tym samym wierszu
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_new_line_between_query_expression_clauses
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wymagaj, aby elementy klauzul wyrażenia zapytania znajdowały się w osobnych wierszach
false Wymagaj, aby elementy klauzul wyrażeń zapytania znajdowały się w tym samym wierszu
domyślna wartość opcji true

Przykłady kodu:

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

Opcje wcięcia

Opcje wcięcia dotyczą użycia wcięcia do formatowania kodu.

Przykładowy plik .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

Własność Wartość Opis
nazwa opcji csharp_indent_case_contents
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wcięcie zawartości wielkości liter switch
false Nie wcięć zawartości sprawy switch
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_indent_switch_labels
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wcięcie etykiet switch
false Nie wcięć etykiet switch
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_indent_labels
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji flush_left Etykiety są umieszczane w lewej kolumnie
one_less_than_current Etykiety są umieszczane w jednym mniejszym wcięcie do bieżącego kontekstu
no_change Etykiety są umieszczane w tym samym wcięcie co bieżący kontekst
domyślna wartość opcji one_less_than_current

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_indent_block_contents
odpowiednie języki C#
wartości opcji true Wcięcie zawartości bloku.
false Nie wcięć zawartości bloku.
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_indent_braces
odpowiednie języki C#
wartości opcji true Wcięcie nawiasów klamrowych.
false Nie wcięć nawiasów klamrowych.
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_indent_case_contents_when_block
odpowiednie języki C#
wartości opcji true Gdy jest to blok, wcięć listę instrukcji i nawiasy klamrowe dla przypadku w instrukcji switch.
false Gdy jest to blok, nie wcięć listy instrukcji i nawiasów klamrowych dla przypadku w instrukcji switch.
domyślna wartość opcji true

Przykłady kodu:

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

Opcje odstępów

Opcje odstępów dotyczą używania znaków spacji do formatowania kodu.

Przykładowy plik .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

Własność Wartość Opis
nazwa opcji csharp_space_after_cast
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść znak spacji między rzutem a wartością
false Usuń spację między rzutem a wartością
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_after_keywords_in_control_flow_statements
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść znak spacji po słowie kluczowym w instrukcji przepływu sterowania, takiej jak pętla for
false Usuwanie spacji po słowie kluczowym w instrukcji przepływu sterowania, takiej jak pętla for
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_parentheses
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji control_flow_statements Umieść odstęp między nawiasami instrukcji przepływu sterowania
expressions Umieść odstęp między nawiasami wyrażeń
type_casts Umieść odstęp między nawiasami w rzutach typu
false (lub dowolną inną wartość) Preferuj brak spacji między nawiasami†
domyślna wartość opcji false†

†Jeśli pominiesz tę regułę lub użyjesz dowolnej wartości innej niż control_flow_statements, expressionslub type_casts, spacje między nawiasami instrukcji przepływu sterowania, wyrażeń i rzutów typu są usuwane.

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_before_colon_in_inheritance_clause
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść znak spacji przed dwukropkiem dla baz lub interfejsów w deklaracji typu
false Usuń spację przed dwukropkiem dla baz lub interfejsów w deklaracji typu
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_after_colon_in_inheritance_clause
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść znak spacji po dwukropku dla baz lub interfejsów w deklaracji typu
false Usuń spację po dwukropku dla baz lub interfejsów w deklaracji typu
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_around_binary_operators
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji before_and_after Wstaw spację przed operatorem binarnym i po nim
none Usuń spacje przed operatorem binarnym i po nim
ignore Ignoruj spacje wokół operatorów binarnych
domyślna wartość opcji before_and_after

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_method_declaration_parameter_list_parentheses
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść znak spacji po nawiasie otwierającym i przed nawiasem zamykającym listy parametrów deklaracji metody
false Usuń znaki spacji po nawiasie otwierającym i przed nawiasem zamykającym listy parametrów deklaracji metody
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_method_declaration_empty_parameter_list_parentheses
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wstaw spację w nawiasach listy pustych parametrów dla deklaracji metody
false Usuń spację w nawiasach listy pustych parametrów dla deklaracji metody
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_method_declaration_name_and_open_parenthesis
odpowiednie języki C#
wartości opcji true Umieść znak spacji między nazwą metody i nawiasem otwierającym w deklaracji metody
false Usuń znaki spacji między nazwą metody i nawiasem otwierającym w deklaracji metody
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_method_call_parameter_list_parentheses
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Umieść znak spacji po nawiasie otwierającym i przed nawiasem zamykającym wywołania metody
false Usuń znaki spacji po nawiasie otwierającym i przed nawiasem zamykającym wywołania metody
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_method_call_empty_parameter_list_parentheses
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wstaw spację w pustych nawiasach listy argumentów
false Usuń spację w pustych nawiasach listy argumentów
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_method_call_name_and_opening_parenthesis
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Wstaw odstęp między nazwą wywołania metody i nawiasem otwierającym
false Usuń odstęp między nazwą wywołania metody i nawiasem otwierającym
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_after_comma
odpowiednie języki C#
wartości opcji true Wstaw spację po przecince
false Usuwanie spacji po przecince
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_before_comma
odpowiednie języki C#
wartości opcji true Wstaw spację przed przecinkiem
false Usuń spację przed przecinkiem
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_after_dot
odpowiednie języki C#
wartości opcji true Wstaw spację po kropki
false Usuń spację po kropki
domyślna wartość opcji false

Przykłady kodu:

// csharp_space_after_dot = true
this. Goo();

// csharp_space_after_dot = false
this.Goo();

csharp_space_before_dot

Własność Wartość Opis
nazwa opcji csharp_space_before_dot
odpowiednie języki C#
wartości opcji true Wstaw spację przed kropką
false Usuń spację przed kropką
domyślna wartość opcji false

Przykłady kodu:

// csharp_space_before_dot = true
this .Goo();

// csharp_space_before_dot = false
this.Goo();

csharp_space_after_semicolon_in_for_statement

Własność Wartość Opis
nazwa opcji csharp_space_after_semicolon_in_for_statement
odpowiednie języki C#
wartości opcji true Wstaw spację po każdym średnik w instrukcji for
false Usuń spację po każdym średnik w instrukcji for
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_before_semicolon_in_for_statement
odpowiednie języki C#
wartości opcji true Wstaw spację przed każdym średnikiem w instrukcji for
false Usuń spację przed każdym średnikiem w instrukcji for
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_around_declaration_statements
odpowiednie języki C#
wartości opcji ignore Nie usuwaj dodatkowych znaków spacji w instrukcjach deklaracji
false Usuwanie dodatkowych znaków spacji w instrukcjach deklaracji
domyślna wartość opcji false

Przykłady kodu:

// csharp_space_around_declaration_statements = ignore
int    x    =    0   ;

// csharp_space_around_declaration_statements = false
int x = 0;

csharp_space_before_open_square_brackets

Własność Wartość Opis
nazwa opcji csharp_space_before_open_square_brackets
odpowiednie języki C#
wartości opcji true Wstaw spację przed otwarciem nawiasów kwadratowych [
false Usuń spację przed otwarciem nawiasów kwadratowych [
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_empty_square_brackets
odpowiednie języki C#
wartości opcji true Wstaw spację między pustymi nawiasami kwadratowymi [ ]
false Usuń spację między pustymi nawiasami kwadratowymi []
domyślna wartość opcji false

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_space_between_square_brackets
odpowiednie języki C#
wartości opcji true Wstaw znaki spacji w niepustych nawiasach kwadratowych [ 0 ]
false Usuń znaki spacji w niepustych nawiasach kwadratowych [0]
domyślna wartość opcji false

Przykłady kodu:

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

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

Opcje zawijania

Opcje formatowania zawijania dotyczą użycia pojedynczych wierszy w porównaniu z oddzielnymi wierszami dla instrukcji i bloków kodu.

Przykładowy plik .editorconfig:

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

csharp_preserve_single_line_statements

Własność Wartość Opis
nazwa opcji csharp_preserve_single_line_statements
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Instrukcje leave i deklaracje składowe w tym samym wierszu
false Instrukcje leave i deklaracje składowe w różnych wierszach
domyślna wartość opcji true

Przykłady kodu:

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

Własność Wartość Opis
nazwa opcji csharp_preserve_single_line_blocks
odpowiednie języki C#
wprowadzona wersja Visual Studio 2017
wartości opcji true Pozostaw blok kodu w jednym wierszu
false Pozostaw blok kodu w oddzielnych wierszach
domyślna wartość opcji true

Przykłady kodu:

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

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

Zobacz też