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.

• csharp_new_line_before_open_brace
• csharp_new_line_before_else
• csharp_new_line_before_catch
• csharp_new_line_before_finally
• csharp_new_line_before_members_in_object_initializers
• csharp_new_line_before_members_in_anonymous_types
• csharp_new_line_between_query_expression_clauses

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.

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

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.

• csharp_space_after_cast
• csharp_space_after_keywords_in_control_flow_statements
• csharp_space_between_parentheses
• csharp_space_before_colon_in_inheritance_clause
• csharp_space_after_colon_in_inheritance_clause
• csharp_space_around_binary_operators
• csharp_space_between_method_declaration_parameter_list_parentheses
• csharp_space_between_method_declaration_empty_parameter_list_parentheses
• csharp_space_between_method_declaration_name_and_open_parenthesis
• csharp_space_between_method_call_parameter_list_parentheses
• csharp_space_between_method_call_empty_parameter_list_parentheses
• csharp_space_between_method_call_name_and_opening_parenthesis
• csharp_space_after_comma
• csharp_space_before_comma
• csharp_space_after_dot
• csharp_space_before_dot
• csharp_space_after_semicolon_in_for_statement
• csharp_space_before_semicolon_in_for_statement
• csharp_space_around_declaration_statements
• csharp_space_before_open_square_brackets
• csharp_space_between_empty_square_brackets
• csharp_space_between_square_brackets

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.

• csharp_preserve_single_line_statements
• csharp_preserve_single_line_blocks

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

• Regla de formato (IDE0055)