Compartir vía


Opciones de formato de C#

Las opciones de formato de este artículo se aplican únicamente al código de C#. Estas son opciones para la regla de estilo de código IDE0055.

Opciones de nueva línea

Estas nuevas opciones de línea se refieren al uso de nuevas líneas para dar formato al código.

Ejemplo del archivo .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

Esta regla se refiere a si se debe colocar una llave de apertura { en la misma línea que el código anterior, o en una línea nueva. Para esta regla, se especifica all, none o uno o varios elementos de código como methods o properties para definir cuándo se debe aplicar esta regla. Para especificar varios elementos de código, sepárelos con una coma (,).

Propiedad. Valor Descripción
Nombre de la opción csharp_new_line_before_open_brace
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción all Se requiere que las claves estén en una nueva línea para todas las expresiones (estilo «Allman»).
none Se requiere que las llaves estén en una nueva línea para todas las expresiones ("K&R").
accessors, anonymous_methods, anonymous_types, control_blocks, events, indexers,
lambdas, local_functions, methods, object_collection_array_initializers, properties, types
Se requiere que las llaves estén en una línea nueva para el elemento de código especificado (estilo «Allman»).
Valor de opción predeterminado all

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_new_line_before_else
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Las instrucciones else se colocan en una nueva línea.
false Las instrucciones else se colocan en la misma línea.
Valor de opción predeterminado true

Ejemplos de código:

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

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

csharp_new_line_before_catch

Propiedad Valor Descripción
Nombre de la opción csharp_new_line_before_catch
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Las instrucciones catch se colocan en una nueva línea.
false Las instrucciones catch se colocan en la misma línea.
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_new_line_before_finally
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Se requiere que las instrucciones finally estén en una nueva línea después de la llave de cierre.
false Se requiere que las instrucciones finally estén en la misma línea que la llave de cierre.
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_new_line_before_members_in_object_initializers
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Se requiere que los miembros de inicializadores de objeto estén en líneas independientes
false Se requiere que los miembros de inicializadores de objeto estén en la misma línea
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_new_line_before_members_in_anonymous_types
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Se requiere que los miembros de tipos anónimos estén en líneas independientes
false Se requiere que los miembros de tipos anónimos estén en la misma línea
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_new_line_between_query_expression_clauses
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Se requiere que los elementos de las cláusulas de la expresión de consulta estén en líneas independientes
false Se requiere que los elementos de las cláusulas de la expresión de consulta estén en la misma línea
Valor de opción predeterminado true

Ejemplos de código:

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

Opciones de sangría

Las opciones de sangría se refieren al uso de sangría para dar formato al código.

Ejemplo del archivo .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

Propiedad Valor Descripción
Nombre de la opción csharp_indent_case_contents
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Aplicar sangría al contenido del caso switch
false No aplicar sangría al contenido del caso switch
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_indent_switch_labels
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Aplicar sangría a etiquetas switch
false No aplicar sangría a etiquetas switch
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_indent_labels
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción flush_left Las etiquetas se colocan en la primera columna de la izquierda
one_less_than_current Las etiquetas se colocan una sangría menos que el contexto actual.
no_change Las etiquetas se colocan en la misma sangría que el contexto actual.
Valor de opción predeterminado one_less_than_current

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_indent_block_contents
Lenguajes aplicables C#
Valores de opción true Aplicar sangría a contenidos de bloque.
false No se debe aplicar sangría el contenido del bloque.
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_indent_braces
Lenguajes aplicables C#
Valores de opción true Aplicar sangría en los corchetes.
false No aplicar la sangría a los corchetes.
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_indent_case_contents_when_block
Lenguajes aplicables C#
Valores de opción true Cuando se trata de un bloque, sangría la lista de instrucciones y llaves para un caso en una instrucción switch.
false Cuando se trata de un bloque, no inserte la lista de instrucciones y llaves para un caso en una instrucción switch.
Valor de opción predeterminado true

Ejemplos de código:

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

Opciones de espaciado

Estas opciones de espaciado se refieren al uso de caracteres de espacio para dar formato al código.

Ejemplo del archivo .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

Propiedad Valor Descripción
Nombre de la opción csharp_space_after_cast
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar un carácter de espacio entre una conversión y el valor
false Quitar el espacio entre la conversión y el valor
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_after_keywords_in_control_flow_statements
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar un carácter de espacio después de una palabra clave en una instrucción de flujo de control como un bucle for
false Quitar el espacio después de una palabra clave en una instrucción de flujo de control como un bucle for
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_parentheses
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción control_flow_statements Se inserta un espacio entre los paréntesis de instrucciones de flujo de control.
expressions Se inserta un espacio entre los paréntesis de expresiones.
type_casts Se inserta un espacio entre los paréntesis de las conversiones de tipos.
false (o cualquier otro valor) Nunca agregue espacios entre paréntesis

Si esta regla se omite o si se usa un valor distinto de control_flow_statements, expressions o type_casts, la configuración no se aplicará.

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_space_before_colon_in_inheritance_clause
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar un carácter de espacio antes de los dos puntos para las bases o interfaces de una declaración de tipos
false Quitar el espacio antes de los dos puntos para las bases o interfaces de una declaración de tipos
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_space_after_colon_in_inheritance_clause
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar un carácter de espacio después de los dos puntos para las bases o interfaces de una declaración de tipos
false Quitar el espacio después de los dos puntos para las bases o interfaces de una declaración de tipos
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad Valor Descripción
Nombre de la opción csharp_space_around_binary_operators
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción before_and_after Insertar espacio delante y detrás del operador binario
none Quitar espacios delante y detrás del operador binario
ignore Omitir espacios alrededor de operadores binarios
Valor de opción predeterminado before_and_after

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_method_declaration_parameter_list_parentheses
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Colocar un carácter de espacio después del paréntesis de apertura y antes del paréntesis de cierre de una lista de parámetros de declaración de método
false Quitar los caracteres de espacio después del paréntesis de apertura y antes del paréntesis de cierre de una lista de parámetros de declaración de método
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_method_declaration_empty_parameter_list_parentheses
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar un espacio dentro de los paréntesis de una lista de parámetros correspondiente a una declaración de método
false Quitar el espacio dentro de los paréntesis de una lista de parámetros correspondiente a una declaración de método
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_method_declaration_name_and_open_parenthesis
Lenguajes aplicables C#
Valores de opción true Insertar un carácter de espacio entre el nombre del método y el paréntesis de apertura en la declaración de método
false Quitar los caracteres de espacio entre el nombre del método y el paréntesis de apertura en la declaración de método
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_method_call_parameter_list_parentheses
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Colocar un carácter de espacio después del paréntesis de apertura y antes del paréntesis de cierre de una llamada de método
false Quitar los caracteres de espacio después del paréntesis de apertura y antes del paréntesis de cierre de una llamada de método
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_method_call_empty_parameter_list_parentheses
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar espacio entre paréntesis vacíos de la lista de argumentos
false Quitar un espacio entre paréntesis vacíos de la lista de argumentos
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_method_call_name_and_opening_parenthesis
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Insertar un espacio entre el nombre de la llamada de método y el paréntesis de apertura
false Quitar un espacio entre el nombre de la llamada de método y el paréntesis de apertura
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_after_comma
Lenguajes aplicables C#
Valores de opción true Insertar un espacio tras una coma
false Quitar un espacio después de una coma
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_before_comma
Lenguajes aplicables C#
Valores de opción true Insertar un espacio delante de una coma
false Quitar el espacio delante de una coma
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_after_dot
Lenguajes aplicables C#
Valores de opción true Insertar un espacio después de un punto
false Quitar un espacio después de un punto
Valor de opción predeterminado false

Ejemplos de código:

// csharp_space_after_dot = true
this. Goo();

// csharp_space_after_dot = false
this.Goo();

csharp_space_before_dot

Propiedad. Valor Descripción
Nombre de la opción csharp_space_before_dot
Lenguajes aplicables C#
Valores de opción true Insertar un espacio delante de un punto
false Quitar el espacio delante de un punto
Valor de opción predeterminado false

Ejemplos de código:

// csharp_space_before_dot = true
this .Goo();

// csharp_space_before_dot = false
this.Goo();

csharp_space_after_semicolon_in_for_statement

Propiedad. Valor Descripción
Nombre de la opción csharp_space_after_semicolon_in_for_statement
Lenguajes aplicables C#
Valores de opción true Insertar un espacio detrás de cada punto y coma de una instrucción for
false Quitar el espacio detrás de cada punto y coma de una instrucción for
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_before_semicolon_in_for_statement
Lenguajes aplicables C#
Valores de opción true Insertar un espacio delante de cada punto y coma de una instrucción for
false Quitar el espacio delante de cada punto y coma de una instrucción for
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_around_declaration_statements
Lenguajes aplicables C#
Valores de opción ignore No quitar caracteres de espacio adicionales de las instrucciones de declaración
false Quitar caracteres de espacio adicionales de las instrucciones de declaración
Valor de opción predeterminado false

Ejemplos de código:

// csharp_space_around_declaration_statements = ignore
int    x    =    0   ;

// csharp_space_around_declaration_statements = false
int x = 0;

csharp_space_before_open_square_brackets

Propiedad. Valor Descripción
Nombre de la opción csharp_space_before_open_square_brackets
Lenguajes aplicables C#
Valores de opción true Insertar espacio delante de corchetes de apertura[
false Quitar el espacio delante de los corchetes de apertura [
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_empty_square_brackets
Lenguajes aplicables C#
Valores de opción true Insertar espacio entre corchetes vacíos[ ]
false Quitar el espacio entre corchetes vacíos []
Valor de opción predeterminado false

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_space_between_square_brackets
Lenguajes aplicables C#
Valores de opción true Insertar caracteres de espacio en corchetes no vacíos [ 0 ]
false Quitar caracteres de espacio en corchetes no vacíos [0]
Valor de opción predeterminado false

Ejemplos de código:

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

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

Opciones de encapsulado

Las opciones de encapsulado formato se refieren al uso de líneas individuales frente a líneas separadas para las instrucciones y bloques de código.

Ejemplo del archivo .editorconfig:

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

csharp_preserve_single_line_statements

Propiedad. Valor Descripción
Nombre de la opción csharp_preserve_single_line_statements
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Se dejan las instrucciones y declaraciones de miembros en la misma línea.
false Se dejan las instrucciones y declaraciones de miembros en líneas diferentes.
Valor de opción predeterminado true

Ejemplos de código:

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

Propiedad. Valor Descripción
Nombre de la opción csharp_preserve_single_line_blocks
Lenguajes aplicables C#
Versión introducida Visual Studio 2017
Valores de opción true Dejar el bloque de código en una sola línea
false Dejar el bloque de código en líneas independientes
Valor de opción predeterminado true

Ejemplos de código:

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

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

Vea también